Testschrittbibliothek
Grundlagen
Die Testschrittbibliothek stellt ähnlich zur Skriptbibliothek des CRMs für die automatisierten Oberflächentests eine Bibliothek zur Verfügung, in der verschiedenste Testschrittmethoden erstellt werden können. Durch die Einführung der Testschrittbibliothek können identische Testschritte in den verschiedenen Testfällen nun an einer Stelle in der Testschrittbibliothek bearbeitet werden. Die Änderung der Testschrittmethode greift dann in allen Testfällen, in denen diese Testschrittmethode verwendet wird.
Ein anschauliches Beispiel ist das Ändern eines Pflichtfeldes auf der Geschäftspartnermaske. Ohne die Testschrittbibliothek müsste der Anwender des Test-Studios jeden einzelnen Testfall bearbeiten, indem eine Pflichtfeldprüfung auf der Geschfäftspartner-Maske vorgenommen wird. Mit der Testschrittbibliothek muss der Anwender nur die eine Stelle in der Testschrittmethode anpassen. Die Änderung wird dann in den einzelnen Testfällen durch den Aufruf der Testschrittmethode übernommen.
Vorteile der Testschrittbibliothek
Testfälle werden insgesamt übersichtlicher.
Zentrale Methoden erleichtern das Schreiben neuer Testfälle.
Die Wartbarkeit der Testfälle wird erhöht, denn es muss nur noch an wenigen, im besten Fall an einer Stelle, Anpassungen vorgenommen werden.
Fehleranalyse wird vereinfacht, da sofort sichtbar ist wenn eine zentrale Methode in mehreren Tests Fehler verursacht.
Konzept und Einschränkungen
Es wird ein Workspace als definierte Einheit von Testschrittbibliothek (Lib) und Testfällen (Test) eingerichtet.
Empfehlung: Ein Workspace pro Unternehmen / CRM System
Parameter; String-basiert
Hinweis für Administratoren (Programmierer):
Keine Return Values möglich, nur Aufrufen von Bibliotheken
Keine globalen Variablen
@Shared def ...
in Bibliotheken
Best Practices
Namensgebung
Testfällen, -methoden und -schritten sollten
CamelCase
konforme Bezeichner erhalten. Bei der Benennung sind Unterstriche (_
) zu vermeiden.Testklassen müssen mit einem Großbuchstaben beginnen, bspw.
CustomerUtils
Testmethode müssen hingegen mit einem Kleinbuchstaben beginnen bspw.
createCustomerSubdata
Der Testfall heißt wie die Datei. Dies wird durch den Editor so vorgegeben. Hier dürfen keine Leer- oder Sonderzeichen verwendet werden. Auf Abweichungen weist der Editor deutlich hin.
Aktionen einer Testschrittbibliotheksmethode
Wenn in einer Methode eine neue Ebene oder Verlaufseintrag im CRM geöffnet wird, sollte der Anwender am Ende der Methode wieder auf der gleichen Ebene bzw. Maske stehen wie vor dem Start der Methode.
Dokumentation
Methoden in der Testschrittbibliothek sollten mit Kommentarblöcken dokumentiert werden:
JAVA/** * Hier steht, was die Methode macht. * * @param meinParameter Dieser Parameter wird von der Methode gebraucht. */
Diese Dokumentation steht später auch über die Autovervollständigung zur Verfügung. Das Dokumentationsformat orientiert sich an JavaDoc.
Bei Methoden, die auf BPM-Prozessmasken arbeiten, sollte der technische Namen der Maske in die Beschreibung aufgenommen werden.
Protokoll
![](../../../__attachments/38174727/image2022-11-3_10-21-44.png?inst-v=01ce9f95-f40d-424e-a7da-0f3a4bad5824)
Dem Protokoll kann entnommen werden, wann eine Testschrittmethode aufgerufen wurde → execute Bibliotheksname.Testschrittmethode
Unterhalb der Testschrittmethode sind die einzelnen Schritte der Methode zu entnehmen
Interaktiver Modus
Detaillierte Informationen zum interaktiven Modus sind hier zu finden: Interaktiver Modus. Durch die Testschrittbibliothek sind folgende Besonderheiten zu beachten:
Einzelne oder mehrere Keywords können sowohl im Testfall als auch in der Bibliothek ausgeführt werden. Dafür sind – wie bisher in Testfällen auch – nur die auszuführenden Keywords einer Testschrittmethode zu markieren.
Besitzt die Methode Parameter, so werden die Werte erfragt, die in dieser interaktiven Ausführung genutzt werden sollen. Bei parameterlosen Methoden entfällt der Schritt.
Breakpoints können nur in einem Testfall gesetzt werden. Ein Breakpoint kann nicht innerhalb einer Testschrittmethode gesetzt werden.
Um dennoch einzelne Keywords einer Methods auszuführen, bietet sich folgendes Vorgehen an:
Breakpoint vor die Aufrufstelle der Methode im Testfall setzen.
Anschließen innerhalb der Methode die Keywords markieren und mittels "Auswahl ausführen" ausführen.
Sollte die Methode Parameter haben, so werden deren Werte abgefragt.
Welcher Wert für den Parameter eingesetzt werden soll, ist dem unteren Bereich des Test-Studios mit der Auflistung aller verwendeter Parameter zu entnehmen.
Die Keywords werden interaktive ausgeführt und tauchen im Protokoll auf.
Die definierten Variablen aus dem Haupttestfall stehen (weiterhin) zur Verfügung.