Arbeiten mit Dictionaries: Unterschied zwischen den Versionen

Aus succestWiki
Wechseln zu: Navigation, Suche
 
Zeile 15: Zeile 15:
  
 
=== UpdateValueInDictionary ===
 
=== UpdateValueInDictionary ===
−
Die UpdateValueInDictionary-Aktivität kann den Wert eines Eintrages in einem Dictionary ändern. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel [[Aktivität UpdateValueInDictionary|UpdateValueInDictionary]]
+
Die UpdateValueInDictionary-Aktivität kann den Wert eines Eintrages in einem Dictionary ändern. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel [[Aktivität UpdateValueInDictionary|UpdateValueInDictionary]] entnehmen.
  
 
=== ClearDictionary ===
 
=== ClearDictionary ===
−
Mithilfe der ClearDictionary-Aktivität kann der gesamte Inhalt eines Dictionaries gelöscht werden. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel [[Aktivität ClearDictionary|ClearDictionary]]
+
Mithilfe der ClearDictionary-Aktivität kann der gesamte Inhalt eines Dictionaries gelöscht werden. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel [[Aktivität ClearDictionary|ClearDictionary]] entnehmen.
  
 
=== HasKeyInDictionary ===
 
=== HasKeyInDictionary ===
−
Die HasKeyInDictionary-Aktivität überprüft mithilfe eines angegebenen Keys, ob ein Eintrag mit diesem Key in dem Dictionary existiert. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel [[Aktivität HasKeyInDictionary|HasKeyInDictionary]]
+
Die HasKeyInDictionary-Aktivität überprüft mithilfe eines angegebenen Keys, ob ein Eintrag mit diesem Key in dem Dictionary existiert. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel [[Aktivität HasKeyInDictionary|HasKeyInDictionary]] entnehmen.
  
 
=== RemoveFromDictionary ===
 
=== RemoveFromDictionary ===
−
Zum Entfernen eines Eintrages aus einem Dictionary wird die Aktivität RemoveFromDictionary verwendet. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel [[Aktivität RemoveFromDictionary|RemoveFromDictionary]]
+
Zum Entfernen eines Eintrages aus einem Dictionary wird die Aktivität RemoveFromDictionary verwendet. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel [[Aktivität RemoveFromDictionary|RemoveFromDictionary]] entnehmen.
  
 
== Anwendungsfall Beispiel ==  
 
== Anwendungsfall Beispiel ==  

Aktuelle Version vom 2. Mai 2018, 09:41 Uhr

Mit einer Sammlung (Collection) von Werten zu arbeiten, um auf Werte einer anderen Sammlung zuzugreifen, kann schnell ziemlich unübersichtlich und kompliziert werden. Somit kann schnell die Komplexität und Unübersichtlichkeit der Testfälle darunter leiden und das möchte sicherlich niemand. Um das Problem der Komplexität und Unübersichtlichkeit im Zusammenhang mit Sammlungen zu lösen, gibt es Dictionaries. Dictionaries sind dafür gedacht, um mit einem Schlüssel (Key) auf einen Wert (Value) oder auch eine Sammlung von Werten (Values) zuzugreifen. Man kann sich das Arbeiten mit Dictionaries wie das Nachschlagen in einem Wörterbuch vorstellen. Meistens besitzt man den Begriff (Key), mit dessen Hilfe man im Wörterbuch nach der Bedeutung (Value) sucht.

Die Dictionary-Aktivitäten interagieren alle mit der .NET Klasse Dictionary<Key, Value>. Wer mehr zu dieser Klasse erfahren möchte, kann dies in der Entwicklerdokumentation von Microsoft nachlesen.

Um im succest Testcase Editor (TCE) mit Dictionaries arbeiten zu können, müssen die jeweiligen Aktivitäten vorher eingebunden werden. Wie das geht, erfahren Sie hier.

Dictionary Aktivitäten

Um das Arbeiten mit Dictionaries zu vereinfachen gibt es 5 verschiedene Aktivitäten.

AddToDictionary

Um einen neuen Eintrag in einem Dictionary zu erzeugen wird die Aktivität AddToDictionary verwendet. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel AddToDictionary entnehmen.

UpdateValueInDictionary

Die UpdateValueInDictionary-Aktivität kann den Wert eines Eintrages in einem Dictionary ändern. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel UpdateValueInDictionary entnehmen.

ClearDictionary

Mithilfe der ClearDictionary-Aktivität kann der gesamte Inhalt eines Dictionaries gelöscht werden. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel ClearDictionary entnehmen.

HasKeyInDictionary

Die HasKeyInDictionary-Aktivität überprüft mithilfe eines angegebenen Keys, ob ein Eintrag mit diesem Key in dem Dictionary existiert. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel HasKeyInDictionary entnehmen.

RemoveFromDictionary

Zum Entfernen eines Eintrages aus einem Dictionary wird die Aktivität RemoveFromDictionary verwendet. Eine genaue Dokumentation dieser Aktivität können Sie dem Artikel RemoveFromDictionary entnehmen.

Anwendungsfall Beispiel

In Abbildung 1 sehen Sie die Verwendung der AddToDictionary-, UpdateValueInDictionary-, HasKeyInDictionary- und der RemoveFromDictionary-Aktivität. In dem Testfall wurde zuvor eine Liste aus einer vorhandenen Datenquelle geladen.

Mit einer Foreach-Aktivität wird nun die Datenquelle durchlaufen. Für jeden Durchlauf werden folgende Aktivitäten in der beschriebenen Reihenfolge ausgeführt. Am Ende einer Wiederholung wird noch eine Integer-Variable hochgezählt, die den eindeutigen Schlüssel in diesem Beispiel darstellt.

Mit der AddToDictionary-Aktivität und der Integer-Variable als Key wird ein Eintrag, mit einem Wert aus der Datenquelle, der Dictionary-Variable MeinDictionary hinzugefügt. Nachdem der Eintrag dem Dictionary hinzugefügt wurde, wird mit der UpdateValueInDictionary-Aktivität das Dictionary nach dem Eintrag, mit dem angegebenen Key durchsucht und der Wert des Eintrages mit einem neuen Wert ersetzt. Mit der HasKeyInDictionary-Aktivität wird anschließend geschaut, ob ein Eintrag mit dem angegebenen Schlüssel im Dictionary existiert. Die boolesche Variable, in diesem Beispiel existsInDictionary, dient dazu, das Ergebnis der Überprüfung festzuhalten. Ist das Ergebnis wahr, so wird der Eintrag anschließend aus dem Dictionary mit der RemoveFromDictionary-Aktivität entfernt, andernfalls beginnt der Durchlauf von vorne, bis alle Einträge aus der Datenquelle durchlaufen wurden.