Aktivität AddToCollection: Unterschied zwischen den Versionen

Aus succestWiki
Wechseln zu: Navigation, Suche
K
 
(29 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
−
Die [[AddToCollection]] Aktivität ist eine Aktivität aus dem Standard der {{WWFvonMS}}. Sie wird verwendet um eine [[Collection]] um einen weiteren Eintrag zu ergänzen. Sie entspricht in ihrem Verhalten der Methode [[https://msdn.microsoft.com/en-us/library/ms132404(v=vs.110).aspx Collection<T>.Add Method (T)] des {{DotNets}}. Die Entwickler Dokumentation von Microsoft befindet sich [https://msdn.microsoft.com/de-de/library/dd648043(v=vs.110).aspx hier].
+
Die [[Aktivität AddToCollection]] ist aus dem Standard der {{WWFvonMS}}. Sie wird verwendet um eine [[Collection]] um einen weiteren Eintrag zu ergänzen. Sie entspricht in ihrem Verhalten der Methode [https://msdn.microsoft.com/en-us/library/ms132404(v=vs.110).aspx Collection<T>.Add Method (T)] des {{DotNets}}. Die Entwickler Dokumentation von Microsoft zur AddToCollection Aktivität befindet sich [https://msdn.microsoft.com/de-de/library/dd648043(v=vs.110).aspx hier].
  
 
== Funktionsweise ==
 
== Funktionsweise ==
−
Die [[AddToCollection]] Aktivität kann mittels [https://de.wikipedia.org/wiki/Drag_and_Drop Drag&Drop] von der [[Toolbox]] auf einen Workflow gezogen und mit anderen Aktivitäten zu einer Schrittfolge verbunden werden. Ist die [[AddToCollection]] Aktivität Teil eines Workflows, wie auf der Abbildung unten gezeigt, können Ihre Felder über das [[Eigenschaftsfenster]] ausgefüllt werden. Im Gegensatz zu vielen anderen Aktivitäten, können die Eigenschaften der [[AddToCollection]] Aktivität nicht direkt auf dem Workflow verändert werden.
+
Die AddToCollection Aktivität kann mittels Drag&Drop von der [[Toolbox]] auf einen Workflow gezogen und mit anderen Aktivitäten zu einer Schrittfolge verbunden werden. Ist die AddToCollection Aktivität Teil eines Workflows, wie auf der Abbildung unten gezeigt, können Ihre Felder über den [[Eigenschaftsbereich]] ausgefüllt werden. Im Gegensatz zu vielen anderen Aktivitäten, können die Eigenschaften der AddToCollection Aktivität nicht direkt auf dem Workflow verändert werden.
  
−
Um die [[AddToCollection]] Aktivität verwenden zu können, muss in dem [[Testfall]] eine [[Collection]] als Variable definiert sein. In der Abbildung unten, ist eine Variable mit dem Namen "EineListe" definiert. Bei der Variablen handelt es sich um eine Liste die [[GUID|Guids]] enthält. Listen sind eine Form von [[Collection]]s, die Variable kann also mit der [[AddToCollection]] Aktivität verwendet werden. Die Belegung der Variablen mit dem Standardwert <code>new List(of Guid)</code> im [[Variablenfenster]], stellt sicher, dass die Variable bei Start des [[Testfall]]s eine gültige aber leere Liste ist.  
+
Um die AddToCollection Aktivität verwenden zu können, muss in dem [[Testfall]] eine [[Collection]] als Variable definiert sein. In der Abbildung unten, ist eine Variable mit dem Namen "EineListe" definiert. Bei der Variable handelt es sich um eine Liste, die [[GUID|Guids]] enthält. Listen sind eine Form von Collections, die Variable kann also mit der AddToCollection Aktivität verwendet werden. Die Belegung der Variablen mit dem Standardwert <code>new List(of Guid)</code> im [[Variablenbereich]], stellt sicher, dass die Variable bei Start des [[Testfall]]s eine gültige aber leere Liste ist.  
  
−
Wie in der Abbildung unten zu sehen, können für die [[AddToCollection]] Aktivität vier Eigenschaften gesetzt werden.
+
Wie in der Abbildung unten zu sehen, können für die AddToCollection Aktivität vier Eigenschaften gesetzt werden.
  
−
=== Collection ===
+
<gallery>
−
Hier wird die Variable eingetragen, die auf die zu ergänzende [[Collection]] zeigt. Die Variable muss initialisiert sein und auf eine gültige Instanz einer [[Collection]] (z. B. eine mit <code>new</code> instanziierte List<T>) zeigen.
+
File:TceScreenAddToCollectionActivity.png|Abb. 1: AddToCollection Aktivität in der Toolbox und im Workflow
 +
</gallery>
  
−
=== Anzeigename ===
+
== Felder ==
 +
* Collection
 +
*: Hier tragen Sie eine Variable ein, die auf eine [[Collection]] zeigt, die Sie um einen Eintrag ergänzen wollen. Die Variable muss initialisiert sein und auf eine gültige Instanz einer Collection (z. B. eine mit <code>new</code> instanziierte <code>List<T></code>) zeigen.
 +
* DisplayName
 +
*: {{DisplayName}}
 +
* Item
 +
*: In das Feld Item geben Sie das Element an, das Sie in die [[Collection]] aufnehmen wollen. Das Element kann sowohl eine Variable, als auch ein sonstiger Ausdruck, wie im Beispiel unten, sein.
 +
* TypeArgument
 +
*: Zuletzt geben Sie im Feld TypeArgument den Typ des Elementes an. Ist beispielsweise Ihr Element eine {{String}} Variable, dann wählen Sie auch in diesem Feld "String" aus. Anwendern, die selbst nicht programmieren, wird es etwas komisch vorkommen, dass man erst beim Erstellen seiner [[Collection]] einen Typ angeben muss. Dann muss man ggf. beim Erstellen der Variablen, die man in die Collection geben möchte wieder den Typ angeben. Und nun bei der AddToCollection Aktivität muss man erneut denselben Typ angeben. Ignorieren Sie das einfach und seien Sie erleichtert, dass es immer der gleiche Typ ist, den Sie angeben müssen.
  
−
<br>Die [[AddToCollection]] Aktivität im [[succest Testcase Editor (TCE)]]:<br>
+
[[Category:Aktivitäten]][[Category:Syntax]][[Category:TCE]]
−
[[File:TceScreenAddToCollectionActivity.png|1280px]]<br>'''Abbildung:''' [[AddToCollection]] Aktivität in der Toolbox und im Workflow
 
−
 
 
−
[[Category:TCE]][[Category:Syntax]][[Category:Aktivitäten]]
 

Aktuelle Version vom 21. März 2018, 15:25 Uhr

Die Aktivität AddToCollection ist aus dem Standard der Windows Workflow Foundation von Microsoft. Sie wird verwendet um eine Collection um einen weiteren Eintrag zu ergänzen. Sie entspricht in ihrem Verhalten der Methode Collection<T>.Add Method (T) des .NET Frameworks. Die Entwickler Dokumentation von Microsoft zur AddToCollection Aktivität befindet sich hier.

Funktionsweise

Die AddToCollection Aktivität kann mittels Drag&Drop von der Toolbox auf einen Workflow gezogen und mit anderen Aktivitäten zu einer Schrittfolge verbunden werden. Ist die AddToCollection Aktivität Teil eines Workflows, wie auf der Abbildung unten gezeigt, können Ihre Felder über den Eigenschaftsbereich ausgefüllt werden. Im Gegensatz zu vielen anderen Aktivitäten, können die Eigenschaften der AddToCollection Aktivität nicht direkt auf dem Workflow verändert werden.

Um die AddToCollection Aktivität verwenden zu können, muss in dem Testfall eine Collection als Variable definiert sein. In der Abbildung unten, ist eine Variable mit dem Namen "EineListe" definiert. Bei der Variable handelt es sich um eine Liste, die Guids enthält. Listen sind eine Form von Collections, die Variable kann also mit der AddToCollection Aktivität verwendet werden. Die Belegung der Variablen mit dem Standardwert new List(of Guid) im Variablenbereich, stellt sicher, dass die Variable bei Start des Testfalls eine gültige aber leere Liste ist.

Wie in der Abbildung unten zu sehen, können für die AddToCollection Aktivität vier Eigenschaften gesetzt werden.

Felder

  • Collection
    Hier tragen Sie eine Variable ein, die auf eine Collection zeigt, die Sie um einen Eintrag ergänzen wollen. Die Variable muss initialisiert sein und auf eine gültige Instanz einer Collection (z. B. eine mit new instanziierte List<T>) zeigen.
  • DisplayName
    In dem Feld "DisplayName" können Sie in wenigen kurzen Worten die Bedeutung der Aktivität für den Ablauf des Testfalls angeben. Alle Aktivität­en haben die Eigenschaft "DisplayName" und zeigen diese im Workflow als Überschrift der Aktivität an. Beispielsweise "Neue Kundennr. merken" ist ein guter "DisplayName". Er ist knapp, deskriptiv und gut verständlich.
  • Item
    In das Feld Item geben Sie das Element an, das Sie in die Collection aufnehmen wollen. Das Element kann sowohl eine Variable, als auch ein sonstiger Ausdruck, wie im Beispiel unten, sein.
  • TypeArgument
    Zuletzt geben Sie im Feld TypeArgument den Typ des Elementes an. Ist beispielsweise Ihr Element eine String Variable, dann wählen Sie auch in diesem Feld "String" aus. Anwendern, die selbst nicht programmieren, wird es etwas komisch vorkommen, dass man erst beim Erstellen seiner Collection einen Typ angeben muss. Dann muss man ggf. beim Erstellen der Variablen, die man in die Collection geben möchte wieder den Typ angeben. Und nun bei der AddToCollection Aktivität muss man erneut denselben Typ angeben. Ignorieren Sie das einfach und seien Sie erleichtert, dass es immer der gleiche Typ ist, den Sie angeben müssen.