Wiederverwendbare Testschritte¶

Testschrittbausteine beschreiben gemeinsame Abläufe einmal und machen sie in mehreren normalen Testfällen nutzbar. Ein Baustein enthält formatierte Testschritte und optional erwartete Ergebnisse. Die Vorbedingungen bleiben am Testfall. Es gibt keine zusätzlichen Attributschemata, Parameter oder eigenen Ausführungsergebnisse je Baustein.

Quick-Testfälle und deren Varianten sind in dieser Ausbaustufe ausgeschlossen. Bausteine starten keinen anderen Testfall und ersetzen keine Testfall-Abhängigkeiten.

Bausteine im Browser pflegen¶

Öffnen Sie im Projekt die Testschrittbausteine. Jeder Baustein gehört zu einer Testeinheit. Zum Lesen benötigen Sie Leserechte auf diese Einheit, zum Pflegen die entsprechenden vollständigen Zugriffsrechte. Die Liste zeigt nur berechtigte Inhalte.

1. Wählen Sie die Testeinheit und vergeben Sie einen aussagekräftigen Titel, etwa „Im Kundenportal anmelden“.
2. Erfassen Sie die Schritte im formatierten Editor und bei Bedarf erwartete Ergebnisse. Eine Änderungsnotiz erläutert einen neuen Stand.
3. Speichern Sie den Baustein. Eine Änderung erzeugt eine neue feste Version.

Archivierte Bausteine bleiben für bestehende Verwendungen erhalten. Eine neue Bausteinversion ändert verwendende Testfälle nicht automatisch.

In einem normalen Testfall verwenden¶

Öffnen Sie einen normalen Testfall in der Testbibliothek, wählen Sie gegebenenfalls die Variante und öffnen Sie die Bearbeitung der wiederverwendbaren Testschritte. Dafür benötigen Sie Bearbeitungsrechte auf den Testfall und Leserechte auf verwendete Bausteine.

Die Zusammensetzung besteht aus geordneten eigenen Abschnitten und Bausteinabschnitten. Eigene Abschnitte enthalten ebenfalls Schritte und optional erwartete Ergebnisse. Ein Bausteinabschnitt verwendet eine ausdrücklich gewählte feste Version. Prüfen Sie Inhalt, Reihenfolge und Gesamtausgabe vor dem Speichern. Beim ersten Wechsel in die verwaltete Bearbeitung werden die bestehenden effektiven Schritte und erwarteten Ergebnisse als eigener Abschnitt übernommen.

Zeigt ein Abschnitt eine neuere Bausteinversion an, öffnen Sie den Vergleich und prüfen Sie bisherigen und neuen Inhalt. Erst die bewusste Übernahme und das Speichern ändern diese Verwendung. Andere Verwendungen behalten ihren bisherigen Stand.

Die Umwandlung eines einzelnen Bausteinabschnitts in eigenen Text erhält dessen Inhalt innerhalb der verwalteten Zusammensetzung. Speichern Sie anschließend die Änderung. Die Aktion zum Umwandeln der gesamten Zusammensetzung löst dagegen deren Verwaltung vollständig und übernimmt Schritte und erwartete Ergebnisse als freie Texte am Testfall. Sie verwendet den zuletzt gespeicherten Stand; speichern Sie gewünschte Änderungen vorher. Prüfen Sie die Vorschau vor der Bestätigung. Andere Testfälle und die Bausteinbibliothek werden durch beide Aktionen nicht geändert.

Varianten können Inhalte der Primärvariante erben. Prüfen Sie beim Anlegen einer eigenen Zusammensetzung, welche effektiven Inhalte übernommen werden. Ein ausdrücklich leer gespeichertes erwartetes Ergebnis einer eigenen verwalteten Zusammensetzung bleibt leer und wird nicht durch den Primärtext ersetzt.

Bilder und Anhänge¶

Inline-Bilder gehören zum Inhalt einer Bausteinversion. Beim Speichern entstehen eigene Bildkopien; ältere Versionen und übernommene Inhalte bleiben deshalb auch nach dem Ändern oder Löschen eines Ausgangsbildes lesbar. Extern verlinkte Bilder liegen außerhalb des Projekts und sind kein dauerhaft gesicherter Inhalt.

Eigene Dateianhänge an Bausteinen sind in dieser Ausbaustufe nicht vorgesehen. Vorhandene Anhänge bleiben am Testfall beziehungsweise an der Variante und werden nicht durch die Version eines Testschrittbausteins versioniert.

Planen und ausführen¶

Schritte und erwartete Ergebnisse bleiben als vollständiger Text lesbar, etwa bei Ausführung, Berichten und Exporten. Die Verwendung eines Bausteins erzeugt keinen zusätzlichen Ergebnisstatus und verändert die Teststatistik nicht.

Eine neue Bibliotheksfassung wird bewusst in die Planvorlage übernommen. Bereits erzeugte Testläufe behalten ihren übernommenen Inhaltsstand einschließlich der verwendeten Bausteinversionen. Neue Inhalte prüfen Sie über einen neuen Lauf beziehungsweise den dafür vorgesehenen Nachtestweg.

Windows und Automatisierung¶

Die Pflege der Bausteine und ihrer Zusammensetzung erfolgt im Browser. Windows zeigt die vollständigen Inhalte an und verwendet sie bei der Ausführung. Verwaltete Schritte und erwartete Ergebnisse sind dort schreibgeschützt; der Web-Link führt zur passenden Bearbeitung beziehungsweise zur schreibgeschützten Ansicht eines geplanten Inhaltsstands. Andere zulässige Angaben des Testfalls bleiben bearbeitbar. Die automatische Anmeldeübergabe verwendet denselben Weg wie Im Web öffnen.

Die MCP-Anbindung verwendet dieselben Projekt- und Objektrechte wie die Oberfläche. Lesefunktionen und vorbereitete Schreibaktionen zur Bausteinpflege, Zusammensetzung und Umwandlung stehen auch über MCP bereit; daraus ergibt sich keine zusätzliche Berechtigung. Die Werkzeugverträge beschreibt Sichere Aktionen und MCP.

Kopieren und Projekte übertragen¶

Beim Import einzelner Inhalte aus einem anderen Projekt werden Bausteinverwendungen als unabhängige eigene Abschnitte übernommen. Es entsteht keine Verbindung zur Bausteinbibliothek des Quellprojekts; deren spätere Änderungen wirken sich nicht aus. Die vollständige Projektübertragung erhält dagegen Bausteine, Versionen und ihre Verwendungen gemeinsam.

Vorhandene Textbausteine bleiben eine Einfügehilfe: eingefügter Text ist eine Kopie ohne nachträgliche Versionsverbindung. Es findet keine automatische Zuordnung oder Migration solcher Texte statt.

Weitere Grundlagen: Testfälle im Browser, Testvarianten und Tests planen.

Die gleichen Operationen sind über die REST-API erreichbar: Lesen mit POST /api/v1/operations/ztm_project_reusable_test_steps und {"operation":"list"}; Schreiben über ztm_project_action_prepare und ztm_project_action_commit. Verwendet werden die Fähigkeiten project.reusable-test-step.save, project.reusable-test-step.composition.save und project.reusable-test-step.composition.detach. Projekt-Header und API-Schlüssel sind erforderlich; dieselben Rechte und Vorschauprüfungen gelten.