Arbeiten mit Dictionaries: Unterschied zwischen den Versionen
| Zeile 24: | Zeile 24: | ||
== Anwendungsfall Beispiel == | == Anwendungsfall Beispiel == | ||
<gallery> | <gallery> | ||
| − | Datei:TceDictionaryBeispiel.png|Abb. | + | Datei:TceDictionaryBeispiel.png|Abb. 1: Dictionary Beispiel im TCE |
</gallery> | </gallery> | ||
| − | In Abbildung | + | 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. | In dem Testfall wurde zuvor eine Liste aus einer vorhandenen Datenquelle geladen. | ||
Version vom 25. April 2018, 15:43 Uhr
Mit einer Sammlung (Collection) von Werten (Keys) zu arbeiten, um auf Werte (Values) 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 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 (Values) 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
Inhaltsverzeichnis
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
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
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
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
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.