Erste Schritte
Aus ExpeccoWiki
Einführung in expecco
Die Ersten Schritte richten sich an alle, die expecco zum ersten mal benutzen wollen und soll als kleine Starthilfe dienen.
Anhand eines einfachen Beispiels wollen wir Ihnen einen Überblick über expecco verschaffen.
Es empfiehlt sich, expecco parallel zum Tutorial zu starten um alle Schritte innerhalb expecco nachvollziehen zu können.
Erzeugen einer neuen Testsuite
Eine Testsuite bezeichnet in expecco die Gesamtheit eines Testprojektes. Um eine neue Testsuite zu erzeugen, klicken Sie auf das Menü Datei → Neue Testsuite oder das entsprechende Bild der Toolbar-Leiste.
expecco ab Version 1.7
Beim Erstellen einer neuen Testsuite wird ab dieser Version die Standard-Bibliothek automatisch importiert. Hier entfällt der nachfolgende Datei-Auswahlschritt.
expecco bis Version 1.6.x
Hier muss die Standard-Bibliothek manuell importiert werden. Klicken Sie dazu auf das Menü Datei → Import/Export → Bibliothek importieren....
Zur Angabe der Bibliotheksdatei wird ein Dateidialog geöffnet. Wechseln Sie mit der Schaltfläche 
zum Bibliotheksverzeichnis und selektieren Sie dort die Standard-Bibliothek (StandardLibrary.ets).
Bausteine in Bibliotheken
Bibliotheken sind eine Zusammenfassung von funktionalen Bausteinen. Bibliotheken finden Sie im Projektbaum (Navigator) unter der Kategorie "Imports". Alle Bausteine innerhalb einer importierten Bibliothek sind schreibgeschützt. Zu jedem Baustein existiert eine Beschreibung und gegebenenfalls ein Beispiel, dass Sie sofort ausführen können.
Selektieren Sie im Projektbaum die Standard-Bibliothek. Diese Bibliothek stellt grundlegende Funktionsbausteine für unterschiedliche Bereiche zur Verfügung.
Innerhalb einer Bibliothek sind die Bausteine in Kategorien organisiert. Zum Beispiel finden Sie diverse Bausteine zur Stringverarbeitung in einer gemeinsamen Kategorie. Zur Veranschaulichung navigieren Sie bitte zur Kategorie "String Processing" und selektieren dort den Baustein "String [ AsUppercase ]".
Rechts werden Editoren bezüglich des selektierten Elements in mehreren Kacheln dargestellt. In der Kachel "Dokumentation" finden sie zu jedem Baustein eine kurze Beschreibung der Funktionalität (diese wird auch links im Auswahlbaum als "FlyBy-Help" angezeigt).
Außerdem gibt es zu den meisten Bausteinen auch einen kleinen Testrahmen, in dem die Funktionalität demonstriert bzw. validiert wird. Wählen Sie die Kachel "test/Demo" aus. In dieser Kachel "Testeditor" kann der Baustein durch Klicken der Schaltfläche 
direkt ausgeführt werden.
Das Resultat der Ausführung wird im unteren Teil angezeigt. Links sehen Sie die hierarchische Aufrufkette, rechts die zu der linken Auswahl zugehörigen Detailinformationen. So sehen Sie in der Kachel "Ein/Ausgänge" die Werte der Ein- und Ausgänge.
Erstellen eines ersten eigenen (zusammengesetzten) Bausteins
Unter Baustein wird die Definition eines Vorgangs bezeichnet. Man unterscheidet zwischen Elementarbausteinen und zusammengesetzten Bausteinen.
Ein Elementarbausteine definiert einen grundlegenden Vorgang, wie beispielsweise einen Protokollaufruf.
Das Verhalten eines zusammengesetzten Bausteins wird durch ein Aktivitätsdiagramm beschrieben. Die Elemente eines Aktivitätsdiagramms sind Schritte, welche über Daten oder Kontrollflüsse verbunden sind.
Klicken Sie in der Toolbar 
die Schaltfläche 
um einen neuen zusammengesetzten Baustein zu erzeugen.
Klicken Sie die Schaltfläche 
und Sie erhalten ein zweites Fenster aus dem sie Bausteine per Drag & Drop in das Netzwerk des neu erstellten Bausteins einfügen können.
Selektieren Sie in der Kategorie "Arithmetic" den Baustein "Arith [ Sum ]" und ziehen Sie diesen Baustein per Drag & Drop in das Netzwerk des neu erstellten Bausteins.
Durch Platzieren des Bausteins im Netzwerk wird ein neuer Schritt angelegt. Da dieser Schritt Eingabewerte erfordert, kann er nicht ausgeführt werden (erkennbar am roten Ausrufezeichen 
). Eingänge und Ausgänge werden als Pins (Anschlüsse) bezeichnet. Im ersten Schritt belegen wir die Eingänge mit festen Werten vor. Dies erreichen Sie über einen Doppelklick auf den Eingangspin 
oder über den entsprechenden Eintrag des Kontextmenüs:
Geben Sie nun eine beliebige Zahl im Eingabefeld ein.
Belegen Sie nun auch den zweiten Eingangspin vor. Der Schritt besitzt nun alle zur Ausführung benötigten Eingangswerte.
Führen Sie ihren neu erstellten Baustein in der Kachel Test aus.
In der Kachel "Ein/Ausgänge" sehen Sie die Eingangswerte und den erwarteten Ausgangswert.
Um die Änderungen des Bausteins im System zu übernehmen, klicken sie auf der Schaltfläche "Übernehmen".
Geben Sie dem Baustein einen Namen; dies erreichen Sie über das Kontextmenü des neu angelegten Bausteins innerhalb des Projektbaums.
Geben Sie einen beliebigen Namen im Eingabefeld ein.
Erstellen eines komplexeren Bausteins
Als Basis hierzu verwenden wir eine Kopie des vorhergehenden Bausteins, welche Sie über das Kontextmenü des selektierten Elements anlegen können (Kopieren dann Einfügen).
Nach dem Einfügen erhalten Sie eine Kopie ihres vorhergehenden Bausteins.
Platzieren Sie nun den Baustein "Arith [ Product ]" über Drag & Drop in das Netzwerk. Danach sollte ihr Netzwerk folgendermaßen aussehen:
Nach der Ausführung des Baustein erhalten Sie folgendes Bild:
Die ausgeführten Aktivitäten werden abhängig von ihrem Ausführungszustand farblich dargestellt; hier grün für erfolgreich ausgeführt. Wie Sie erkennen können, wurde bezüglich des neue platzierten Schritts keine Aktivität gestartet. Diesem Schritt fehlen die benötigten Eingabewerte (erkennbar am roten Ausrufezeichen).
Dazu verbinden wir die Eingänge und Ausgänge der Schritte untereinander.
Die meisten Verbindungen sind Datentyp orientiert d.h. sie müssen den gleichen Datentyp am Anfang und am Ende der Verbindung haben. So kann beispielsweise kein Text in einen Additionsbaustein eingeführt werden.
Falls Ein- und Ausgangsdatentyp nicht übereinstimmen, stehen in der Standard-Bibliothek unter der Kategorie "Type Conversion" verschiedene Konvertierungsbausteine zur Verfügung.
Um ein Verbindung einzurichten, gehen Sie folgendermaßen vor:
- Selektieren Sie mit der linken Maustaste den Ausgangspin "sum" am Schritt "Arith [ Sum ]" und halten Sie diese gedrückt.
- Ziehen Sie nun mit gedrückter Maustaste ein Verbindung zum Eingangspin "number1" am Schritt "Arith [ Product ]" und lösen sie die Maustaste über dem Eingangspin
.
Wiederholen Sie diesen Schritt und verbinden Sie zusätzlich den Ausgangspin "sum" mit dem Eingangspin "number2".
Führen Sie den Baustein erneut aus; wie Sie erkennen können wurden jetzt für alle Schritte Aktivitäten ausgeführt.
Übernehmen Sie nun den Baustein und benennen Sie ihn in "2. Baustein" um.
Hinzufügen von Ausgangspins zu einem Baustein
Als Basis hierzu verwenden wir eine Kopie des vorhergehenden Bausteins, welche Sie über das Kontextmenü anlegen können (Kopieren dann Einfügen).
Sie erhalten folgendes Bild:
Die Schnittstelle eines Bausteins wird über seine Eingänge und Ausgänge beschrieben. Im Schema-Editor werden die Eingangspins auf der linken Seite, die Ausgangspins auf der rechten Seite dargestellt. Jedem Pin wird ein Datentyp zugewiesen.
Um neue Pins zu erzeugen gibt es unterschiedliche Möglichkeiten:
- Klicken Sie auf die Schaltfläche
innerhalb des Schema-Editor und Sie erzeugen einen neuen Ein- bzw. Ausgangspin.Um den voreingestellten Datentyps zu ändern, klicken Sie auf den Datentyp und wählen Sie aus dem erscheinenden Menü den gewünschten Datentyp aus.
- Ziehen Sie den entsprechenden Ein- bzw. Ausgangspin des Schrittes innerhalb des Netzwerks an die linke bzw. rechte Seite des Editors.
Nach lösen der Maustaste am linken Rand sehen Sie folgendes Bild:
Erzeugen Sie den Ausgangspin wie in Beispiel 2 beschrieben.
Selektieren Sie die Kachel Schema und Sie erhalten folgendes Bild:
Der Baustein hat einen neuen Ausgangspin erhalten, der Datentyp sowie der Name des Ausgangspins wurde vom intern verbundenen Ausgangspin im Netzwerk übernommen. Durch Klicken auf den Namen des Pins kann dieser umbenannt werden.
Um einen bestehenden Ein- bzw. Ausgangspin zu löschen, selektieren Sie den entsprechenden Pin und klicken auf die Schaltfläche 
.
Führen Sie den Baustein erneut aus und Sie erhalten folgendes Bild:
Der Ausgangswert steht nun zur weiteren Verwendung am Ausgangspin zur Verfügung.
Übernehmen Sie nun den Baustein und benennen Sie ihn in "3. Baustein" um.
Hinzufügen von Eingangspins zu einem Baustein
Als Basis hierzu verwenden wir eine Kopie des vorhergehenden Bausteins, welche Sie über das Kontextmenü anlegen können (Kopieren dann Einfügen).
Sie erhalten folgendes Bild:
Um den Schritt "Arith [ Sum ]" von außen zu versorgen, erzeugen Sie die Eingangspins (gleiche Vorgehensweise wie bei den Ausgangspins):
| 
|
| Führen Sie die gleiche Aktion für den zweiten Eingangspin "number2" durch: |
| 
|
Sie erhalten folgendes Bild:
Führen Sie den Baustein erneut aus und Sie erhalten folgendes Bild:
Wie Sie erkennen können, konnte der Baustein nicht ausgeführt werden, da die erforderlichen Eingabewerte an den Eingangspins unseres Testbausteins fehlen. Belegen Sie nun die Eingänge mit festen Eingangswerten vor:
Führen Sie den Baustein erneut aus und Sie erhalten folgendes Bild:
Schalten Sie nun auf die Kachel Schema um. Hier können Sie die Ausführungsbedingung für den Baustein festlegen. Klicken Sie hierfür auf das Feld "Und-Verbunden". Ein Untermenü zur Konfiguration wird angezeigt:
Hier können Sie spezifizieren, welche Eingangspins Werte erhalten haben müssen um zur Ausführung zu kommen. 3 Möglichkeiten werden unterstützt:
- Und-Verbunden
Alle verbundenen Eingangspins müssen Werte erhalten haben, offene Eingänge werden ignoriert. - Und
alle Eingangspins müssen Werte erhalten haben. - Oder
mindestens ein Eingangspin muss einen Wert erhalten haben.
In unserem Fall müssen alle Eingangswerte anliegen, also wählen Sie die "Und" Bedingung aus.
Übernehmen Sie nun den Baustein und benennen Sie ihn in "4. Baustein" um.
Wiederverwendung von Bausteinen
Die Arbeitsweise mit Bausteinen ist der Schlüssel zu Wiederverwendbarkeit und Flexibilität. Einmal erstellte Bausteine können in beliebigen zusammengesetzten Bausteinen wiederverwendet werden.
Legen Sie einen neuen zusammengesetzten Baustein durch Klicken der Schaltfläche an. Nun ziehen Sie per Drag & Drop den vorher erstellten Baustein in das Netzwerk (Aktivitätsdiagramm) des neu angelegten Bausteins.
Fügen Sie zusätzlich noch Bausteine aus der Standard-Bibliothek hinzu und stellen Sie die Verbindungen wie im folgenden Netzwerk her.
Sie finden die Bausteine unter den Kategorien:
- Data Generators
Random [ Integers ] - Compare
Compare [ Greater 2-Way ] - Assertions, Exceptions & Logging
Log [ Info ], Log [ Failure ]
Durch den vorgeschalteten "Random [ Integers ]" Baustein wird der erstellte "4. Baustein" bei jedem Durchlauf mit anderen Werten versorgt, was zu unterschiedlichen Resultaten führt. Dies können Sie am besten sehen, wenn Sie den Baustein in der Kachel "Test" mehrfach ausführen.
Übernehmen Sie nun den Baustein und benennen Sie ihn in "5. Baustein" um.
Sequentielle Ausführung von Schritten
Bei einem Diagramm ohne Datenflüsse (also mit ausschließlichen Kontrollflüssen) werden Triggerein- mit Triggerausgängen verbunden, wodurch ein reines Flussdiagramm entsteht.
Zur Vorbereitung legen Sie einen neuen Zusammengesetzten Baustein durch Klicken der Schaltfläche an. Ziehen Sie per Drag & Drop die Bausteine 1 und 2 in ihr Netzwerk damit Sie folgendes Bild erhalten:
Selektieren Sie den Schritt "1.Baustein". Durch halten der Shift-Taste können Sie den Schritt "2.Baustein" zur Selektion hinzufügen. Beide Schritte sind jetzt in der Reihenfolge selektiert, in der diese sequentiell ausgeführt werden sollen. Durch Klicken der Schaltfläche  wird jetzt eine Kontrollflussverbindung von Schritt 1 zu Schritt 2 eingerichtet.
| 
|
| Nach dem Ausführen des Bausteins in der Test Kachel erhalten Sie folgendes Bild. Wie Sie erkennen können, wurde der Schritt "1.Baustein" vor Schritt "2.Baustein" ausgeführt. | 
|
Sie löschen eine Verbindung indem Sie die Verbindung selektieren und anschließend die Taste Entfernen oder die Schaltfläche  betätigen.
Löschen Sie nun die bestehende Kontrollflussverbindung und richten Sie den Kontrollfluss in umgekehrter Richtung ein. Gehen Sie dazu wie oben beschrieben vor nur selektieren Sie dieses mal den Schritt "2.Baustein" vor Schritt "1.Baustein". | 
|
Nach dem Ausführen des Bausteins erhalten Sie nun folgendes Fehlerbild:
| Wie Sie im Netzwerk Editor erkennen können, ist der Schritt "2.Baustein" durch ein rotes Ausrufezeichen markiert, also nicht bereit zur Ausführung. | 
|
Der Schritt besitzt einen offenen Trigger-Eingangspin. Durch Verbinden des Triggereingangs mit einem beliebigen anderen Ausgangspin kann die Aktion des Schrittes dann ebenfalls ausgelöst werden. Löschen Sie in unserem Fall den Triggereingang durch Selektion und betätigen Sie dann die Taste Entfernen.
Um einen Schritt zur Ausführung zu bringen, muss dieser mindestens einen verbundenen nicht-Parameterpin oder die Autostart-Eigenschaft besitzen. Markieren Sie deshalb den Schritt 2 als Autostart. Selektieren Sie dazu den Schritt und klicken auf die Schaltfläche  .
| 
|
| Nach dem Ausführen des Bausteins in der Test Kachel erhalten sie folgendes Bild. Wie Sie erkennen können wurde der Schritt "2.Baustein" vor Schritt "1.Baustein" ausgeführt. | 
|
Erstellen eines Testplans
In expecco wird eine Sammlung mehrerer Testfälle als Testplan bezeichnet. Zur Durchführung eines Testplans werden alle Einzeltestfälle sequentiell ausgeführt.
Klicken Sie in der Toolbar die Schaltfläche 
um einen neuen Testplan zu erzeugen.
Ziehen Sie nun per Drag & Drop die neu erzeugten Bausteine in den Testplan-Editor. Wie Sie schnell feststellen können, lässt sich der Baustein "4. Baustein" nicht zum Testplan hinzufügen. Bausteine mit offenen Eingängen können nicht in Testplänen verwendet werden. Sie erhalten folgendes Bild:
Übernehmen Sie den Testplan und führen Sie ihn durch betätigen der Schaltfläche aus.
Sie erhalten folgendes Bild:
Da der "5. Baustein" intern mit zufällig erzeugten Eingabewerten arbeitet, erhalten Sie bei mehrfacher Ausführung des Testplans unterschiedliche Ergebnisse.
Erstellen eines Berichts (Report)
Zur Vorbereitung führen Sie den Testplan aus. Um einen detaillierten Bericht über ihre Testausführung zu erstellen, klicken Sie auf die Schaltfläche 
.
Das Dialogfenster "Reportgenerierung / Druck" wird geöffnet. Vor der Erzeugung ihres Berichts müssen noch einige Einstellungen festlegt werden:
- Ausgabeformat:
Die Berichte können in verschiedenen Ausgabeformaten erzeugt werden. Eine Mehrfachauswahl ist möglich.
- Reportsprache:
Einstellung der Sprache für den Bericht festlegen.
- Papierformat:
Ausschließlich beim Ausgabeformat PDF wird hier das Papierformat spezifiziert. Für alle anderen Formate wird diese Einstellung ignoriert.
- Reportvorlage:
Über Reportvorlagen lassen sich Inhalt und Erscheinungsbild des Berichts bestimmen.
Weitere Informationen finden Sie unter Report Generation (englisch).
Klicken Sie auf die Schaltfläche "Report generieren" um die Berichtserstellung zu starten. Nach Erstellung wird die Datei in einem Browser geöffnet.
Speichern der Testsuite
Um die neu erzeugte Testsuite zu speichern, klicken Sie auf das Menü "Datei" → "Sichern als...". Ein Dateibrowser wird geöffnet.
Schlusswort
In unserem Beispiel haben wir mit Absicht einfache Bausteine aus der Standard Bibliothek ausgewählt um ihnen die Arbeitsweise mit expecco näher zu bringen.
Über spezifische Bausteine (TCP/IP, DLL-Calls, FTP, ...) und diversen Bibliotheken und Plugins wird das System Under Test an expecco angebunden.
Für das Testen von Webapplikationen empfehlen wir ihnen das Dokument:
http://wiki.expecco.de/index.php5/Expecco_web_de (Erste Schritte).
Weitere Beispiele finden Sie unter:
http://wiki.expecco.de/index.php5/Examples (englisch).
