Aufzeichnung

Der Aufzeichnungs-Workflow ermöglicht es Ihnen, einen Test zu erstellen (oder zu erweitern), indem Sie in einem Live-Browser mit der Anwendung interagieren. Jede Interaktion wird beobachtet, von der KI in einen natürlichsprachlichen Schritt übersetzt und in die Testdefinition eingefügt. Sie können aufgezeichnete Schritte mit manuell geschriebenen kombinieren, die Formulierung der KI jederzeit bearbeiten und innerhalb derselben Sitzung zwischen automatischer Wiedergabe und manueller Aufzeichnung wechseln.

Die Aufzeichnung ist in beide Richtungen interaktiv:

• Sie steuern den Browser. Klicken Sie auf ein Element in der Live-Vorschau und wählen Sie Klicken, Eingeben, Bestätigen, Scrollen, Drag & Drop usw. – die KI beschreibt den gerade erfolgten Vorgang als Schritt.
• msg.ZenTestAI steuert den Browser. Drücken Sie Nächster Schritt oder Ausführen, und der Runner spielt die vorhandenen Schritte einzeln oder bis zum Ende ab. Sie können die Wiedergabe jederzeit pausieren, den Wiedergabe-Cursor verschieben und wieder zur Aufzeichnung zurückkehren.

Wann Sie die Aufzeichnung verwenden sollten

Die Aufzeichnung ist am schnellsten, wenn:

• Sie einen unkomplizierten End-to-End-Test für eine UI erstellen müssen, die Sie bereits kennen,
• Sie einen bestehenden Test um einige zusätzliche Schritte erweitern möchten, ohne den gesamten Ablauf neu tippen zu müssen,
• ein aufgezeichneter Lauf fehlgeschlagen ist und Sie ab dem fehlgeschlagenen Schritt übernehmen möchten, um ihn entweder zu korrigieren oder einen neuen Pfad einzuschlagen.

Für tief parametrisierte oder sehr assertionslastige Tests ist das manuelle Schreiben von Prompts oft übersichtlicher – die Aufzeichnung eignet sich am besten zum Erfassen der Aktionen. Nach der Aufzeichnung können Sie die Beschreibung jedes Schrittes bearbeiten, um sie allgemeiner zu gestalten, zu parametrisieren oder Makros hinzuzufügen.

Starten einer Aufzeichnung

Es gibt vier Möglichkeiten, in den Aufzeichnungs-Workflow zu gelangen:

• Test aufzeichnen — die Schaltfläche im Header der Testdetailseite. Startet eine neue Sitzung am Ende der bestehenden Schritte (Anfügemodus). Nur für normale Tests (keine Snippets) sichtbar, bei gespeicherten Tests, wenn Sie Bearbeitungsrechte haben und der Test nicht an ein externes System gebunden ist.
• Ab hier aufzeichnen — erscheint inline zwischen zwei beliebigen Schritten im Reiter „Schritte“, wenn Sie den Mauszeiger über die Lücke bewegen. Fügt neue aufgezeichnete Schritte genau an dieser Position ein; die Schritte davor werden abgespielt, um zuerst den Browser-Status einzurichten.
• Aufzeichnung ab hier starten — erscheint im Schritt-Pop-over, wenn Sie einen Schritt aus einer abgeschlossenen Ausführung auf der Seite „Testausführungen“ öffnen. Nützlich, um zu einem bestimmten Punkt eines vergangenen Laufs zurückzukehren und eine andere Fortsetzung aufzuzeichnen.
• Nach einem Fehler in den interaktiven Modus wechseln — wenn eine normale Testausführung fehlschlägt, fragt ein Dialog, ob der Fehler erwartet wurde. Wenn Sie Nein (In interaktiven Modus wechseln) wählen, schaltet die laufende Ausführung in die Aufzeichnung um, wobei alle früheren Schritte so erhalten bleiben, wie sie ausgeführt wurden.

Wenn der Test mehrere Ausführungsvarianten hat, werden Sie gefragt, welche verwendet werden soll – die Aufzeichnung führt immer nur eine einzige Variante aus.

hinweis

Snippets können nicht aufgezeichnet werden. Die Schaltflächen Test aufzeichnen und Ab hier aufzeichnen (pro Schritt) sind für Tests vom Typ Snippet ausgeblendet.

Der Aufzeichnungsbildschirm

Die Aufzeichnungsansicht ersetzt den Reiter „Schritte“ durch ein Layout mit zwei Bereichen:

• Linker Bereich – die Schrittliste. Jeder Schritt des Tests wird als nummerierte Zeile mit einem Statussymbol (ausstehend, läuft, bestanden, fehlgeschlagen) angezeigt. Der aktuell aktive Schritt ist hervorgehoben, und zwischen den Zeilen befindet sich eine verschiebbare Aktionsleiste, die markiert, wo die Wiedergabe fortgesetzt wird.
• Rechter Bereich – der Live-Browser. Eine echte Browsersitzung, die vom Runner gesteuert wird. Sie sehen, was der Runner sieht, mit einer URL-Leiste, Navigations-Elementen (Zurück / Vor / Neu laden), einem Sperrschalter und einer Dev-Console-Schaltfläche.

Die Trennlinie zwischen den beiden Bereichen ist in der Größe anpassbar.

Der Sperrschalter

Die Browser-Vorschau verfügt über einen Sperren / Entsperren-Schalter in der Symbolleiste, der bestimmt, was passiert, wenn Sie in die Vorschau klicken:

• Gesperrt (Standard während der Aufzeichnung) — ein Klick auf den Screenshot öffnet das Aktionsmenü und erstellt einen Schritt.
• Entsperrt — ein Klick auf den Screenshot erstellt keinen Schritt. Stattdessen können Sie den Browser frei steuern: klicken, tippen, hovern, Tasten drücken, scrollen, die URL in der Adressleiste bearbeiten usw. Verwenden Sie dies, wenn Sie den Browser vor dem nächsten aufgezeichneten Schritt in einen bestimmten Zustand versetzen müssen (z. B. ein Banner schließen, das Sie nicht im Test haben möchten, zu einem Abschnitt scrollen, sich über eine Einmal-UI anmelden, die nicht aufgezeichnet werden soll).

Die Sperrtaste pulsiert, wenn Sie den Wiedergabe-Cursor verschieben, als Hinweis darauf, dass der Browser-Status möglicherweise angepasst werden muss, um dem neuen Startpunkt zu entsprechen.

Einen Schritt erfassen

Wenn der Browser gesperrt ist, bewegen Sie den Mauszeiger über die Live-Vorschau – eine rote Markierung folgt Ihrer Maus. Klicken Sie auf ein beliebiges Element, und ein kleines Aktionsmenü erscheint neben dem Cursor. Wählen Sie den Aktionstyp, und die KI übersetzt den Klick + die Aktion in einen natürlichsprachlichen Schritt:

Aktion	Was wird erfasst?
Klicken	Ein einfacher Linksklick auf das ausgewählte Element.
Eingeben	Eine Texteingabe. Ein kleines Pop-over fragt nach dem Text und bietet einen Mit Enter bestätigen-Schalter.
Aus Combobox wählen	Eine Auswahl in einer Combobox / einem Dropdown. Das Pop-over fragt nach der auszuwählenden Option.
Zusätzliche Mausaktionen	Untermenü mit Hover, Fokus, Rechtsklick, Doppelklick, Dreifachklick, Mittelklick, Zurück-Button-Klick, Vorwärts-Button-Klick und Drag & Drop.
Bestätigen	Ein Erwartungsschritt. Das Pop-over fragt nach dem Erwartungstext – z. B. "die Seite zeigt ein grünes Erfolgs-Badge".
Scrollen	Scrollt einen bestimmten Container um einen Pixel-Versatz. Das Pop-over bietet die verfügbaren scrollbaren Container an.
Freestyle	Ein natürlichsprachlicher Schritt in freier Form, der an das angeklickte Element gebunden ist. Verwenden Sie dies, wenn keiner der eingebauten Aktionstypen passt.

Für Drag & Drop klicken Sie zweimal: zuerst auf das Quellobjekt, dann auf das Zielobjekt.

Nachdem Sie die Aktion bestätigt haben, analysiert die KI den Screenshot, den Accessibility-Tree und die in Frage kommenden XPath-Selektoren und erstellt:

• eine natürlichsprachliche Schrittbeschreibung (z. B. "Klicken Sie auf den Button 'Speichern'"),
• einen versteckten XPath-Hinweis, der den XPath-Cache vorab füllt, sodass zukünftige Testläufe den KI-Aufruf zur Identifizierung des Elements überspringen können.

Der Schritt erscheint sofort in der Schrittliste und wird im Backend automatisch gespeichert – es gibt keinen separaten „Genehmigen“-Schritt. Sie können die Formulierung jederzeit bearbeiten (siehe Schritte bearbeiten unten).

tipp

Der Ablauf „Sperren und Aktionsmenü“ ist der empfohlene Weg zur Aufzeichnung. Versuchen Sie nicht, während der Sperrung das Rechtsklick-Kontextmenü des Browsers oder Tastenkombinationen innerhalb der Vorschau zu verwenden – diese erzeugen keine Schritte.

Steuerung der Wiedergabe

Die Schrittliste steuert, wie der Runner bestehende Schritte wiedergibt:

• Nächster Schritt ▼ — inline beim aktuell aktiven Schritt. Führt den Schritt aus und pausiert beim nächsten.
• Ausführen ▶ — führt den Test von der aktuellen Position bis zum Ende aus, ohne zu pausieren. Verwenden Sie dies, um einen bekanntermaßen guten Abschnitt zu überspringen.
• Bis hierhin ausführen — erscheint in der Lücke zwischen zwei Schritten. Spielt alles bis zu dieser Lücke ab und pausiert dann.
• Aktionsleiste ziehen — die Wiederaufnahme-Linie zwischen zwei Schritten kann nach oben oder unten gezogen werden, um den Punkt zu ändern, an dem die Wiedergabe fortgesetzt wird. Beachten Sie, dass dies den Browser nicht zurückspult; Sie müssen ihn möglicherweise manuell entsperren und anpassen, um der neuen Startposition zu entsprechen.

Die Liste scrollt automatisch zum aktiven Schritt. Jede Schrittzeile kann erweitert werden, um die einzelnen Browser-Operationen (Klicken, Eingeben, Bestätigen, …) anzuzeigen, aus denen sie besteht, jeweils mit einem eigenen Erfolg/Fehler-Indikator – nützlich, um genau zu diagnostizieren, welche Unteraktion fehlgeschlagen ist.

Schritte hinzufügen, bearbeiten und löschen

Sie können aufgezeichnete Schritte jederzeit mit manuell geschriebenen mischen:

• Schritt hinzufügen — sowohl in der Aktionsleiste als auch inline zwischen zwei bestehenden Schritten. Öffnet einen kleinen Editor, in dem Sie den Schritt in natürlicher Sprache beschreiben, ohne mit dem Browser zu interagieren. Der neu hinzugefügte Schritt übernimmt die Position, an der Sie ihn geöffnet haben.
• Schritt bearbeiten — klicken Sie auf den Beschreibungstext in einer beliebigen Schrittzeile. Es öffnet sich ein Pop-over mit dem Text des Schrittes, der Aufschlüsselung der Unteraktionen sowie den Schaltflächen Speichern / Abbrechen / Löschen. Das Bearbeiten ersetzt den gesamten Schritttext; wenn Sie beim Bearbeiten zusätzlich auf ein Element im Screenshot klicken, löst die KI den Schritt für dieses neue Element erneut auf.
• Schritt löschen — die Schaltfläche „Löschen“ innerhalb des Schritt bearbeiten-Pop-overs. Erfordert eine Bestätigung.

Es gibt keine Zusammenführung oder teilweises Überschreiben von bearbeiteten Beschreibungen – der neue Text ersetzt den alten vollständig, und der Runner löst die Aktion beim nächsten Testlauf von Grund auf neu auf.

Wiederherstellung nach einem fehlgeschlagenen Schritt

Wenn ein Schritt während der Aufzeichnung fehlschlägt, wird die fehlerhafte Zeile rot, und die Aktionsleiste bietet folgende Optionen:

• Aufzeichnung beenden — die Sitzung stoppen und den Test so belassen, wie er ist, inklusive des Fehlers.
• Fehlgeschlagenen Schritt zurücksetzen — die Wiederaufnahme-Linie um einen Schritt zurückbewegen. Sie können dann den Browser entsperren, bei Bedarf den Status anpassen und es mit Nächster Schritt erneut versuchen oder eine Alternative aufzeichnen.
• Schritt hinzufügen — einen neuen Schritt an der aktuellen Position einfügen (z. B. ein zusätzliches Warten, eine Assertion oder einen Workaround-Klick).

Sie können auch die Beschreibung des fehlerhaften Schrittes direkt bearbeiten, um zu sehen, ob eine klarere Formulierung das Problem löst.

Beim ersten Mal, wenn ein Schritt in einer Aufzeichnungssitzung fehlschlägt, erscheint ein erklärender Dialog. Er enthält ein Kontrollkästchen Nicht automatisch anzeigen, falls Sie feststellen, dass er stört.

Empfehlungsmodus

Wenn Sie sich nicht sicher sind, wie Sie einen Schritt für ein bestimmtes Element formulieren sollen, schalten Sie das Schritt-Pop-over in den Empfehlungsmodus und klicken Sie auf das Element, mit dem Sie interagieren möchten. Die KI liefert bis zu vier alternative Schrittbeschreibungen für dieses Element + Aktion – zum Beispiel "Klicken Sie auf den Button Speichern", "Klicken Sie auf den primären Aktionsbutton in der Dialog-Fußzeile", "Klicken Sie auf den Button mit der Beschriftung 'Speichern' im Dialog 'Neuer Auftrag'". Wählen Sie diejenige aus, die am besten zu Ihrer Zielgruppe passt, und fügen Sie sie in die Schrittbeschreibung ein.

Der Empfehlungsmodus ist schreibgeschützt – er ändert den Schritt nicht von selbst, sondern schlägt nur Formulierungen vor. Er ist für Login-Schritte nicht verfügbar.

Eine Aufzeichnungssitzung beenden

Wenn der Runner das Ende des Tests erreicht (TEST_DONE-Status), zeigt die Aktionsleiste zwei Schaltflächen:

• Aufzeichnung beenden — beendet die Sitzung. Der Browser schließt sich, und Sie kehren zur Standard-Testdetailansicht zurück.
• Schritt hinzufügen — fügt vor dem Beenden einen weiteren Schritt hinzu.

Während sich der Test im TEST_DONE-Status befindet, können Sie auch einfach auf ein beliebiges Element in der Live-Vorschau klicken, um direkt einen weiteren Schritt aufzuzeichnen – ohne dazwischenliegendes Menü, da keine weiteren vorbestehenden Schritte abzuspielen sind.

Wenn Sie einfach den Browser-Tab schließen oder wegnavigieren, bleiben alle bereits erfassten Schritte in der Testdefinition gespeichert (die Aufzeichnung speichert kontinuierlich automatisch). Die Runner-Seite der Sitzung wird abgebrochen.

Login und Authentifizierung

Wenn der Test einen Login erfordert, verwendet der Runner den konfigurierten Benutzer / Rolle des Tests und den Login-Agenten, um sich anzumelden, bevor die Aufzeichnungssitzung interaktiv wird – Sie müssen den Login-Ablauf nicht selbst aufzeichnen. Der erste interaktive Schritt ist derjenige, der nach dem Login folgt.

Falls Sie einen Login-Ablauf manuell aufzeichnen müssen – z. B. für ein Snippet oder um einen nicht standardmäßigen Authentifizierungsbildschirm zu erfassen –, entsperren Sie den Browser, führen Sie die Schritte zuerst manuell aus und sperren Sie ihn dann wieder, um die Aufzeichnung ab dem Status nach dem Login fortzusetzen. (Beachten Sie, dass Snippets derzeit immer noch nicht aufgezeichnet werden können; Sie müssten den Login innerhalb eines normalen Tests durchführen.)

Einschränkungen

Dinge, die der Aufzeichnungs-Workflow derzeit nicht unterstützt:

• Snippets — nur normale Tests können aufgezeichnet werden.
• Native Dateiauswahl — Datei-Uploads über den Dateidialog des Betriebssystems können nicht aufgezeichnet werden. Verwenden Sie stattdessen eine Datei-Upload-Zuweisung für den Schritt.
• Mehrere Varianten in einer Sitzung — Sie müssen beim Starten der Aufzeichnung eine einzelne Variante auswählen.
• Remember / in Parameter erfassen — es gibt keine spezielle Schaltfläche, um einen Remember-Schritt aufzuzeichnen. Fügen Sie den Schritt manuell über Schritt hinzufügen hinzu und schreiben Sie den Remember …-Prompt; der Parameter wird aus dem Text übernommen.
• Parameter- und Makro-Auswahl im Aufzeichnungs-Pop-over — das Schritt bearbeiten-Pop-over verbirgt derzeit die Parameter/Makro-Autovervollständigung (=). Wenn Sie einen Parameterverweis innerhalb eines aufgezeichneten Schrittes wünschen, bearbeiten Sie den Schritt nach dem Ende der Aufzeichnungssitzung im normalen Reiter „Schritte“ oder schreiben Sie [[PARAMETER_NAME]] manuell.
• Per-Frame-Accessibility in verschachtelten Iframes — Klicks innerhalb von Iframes funktionieren im Allgemeinen, aber das Auslesen des Accessibility-Trees ist weiterhin auf den Haupt-Frame beschränkt; falls sich die Aufzeichnung innerhalb eines Iframes merkwürdig verhält, versuchen Sie, den Browser zu entsperren und das Element direkt anzuklicken.

Sonstiges Wissenswertes

• Leerlauf-Timeout. Eine Aufzeichnungssitzung läuft nach etwa 10 Minuten ohne Benutzerinteraktion ab; der Runner verlässt dann den interaktiven Modus und führt den Test selbstständig zu Ende (oder schlägt fehl). Klicken Sie ab und zu auf etwas, wenn Sie die Aufzeichnung pausieren.
• Kosten. Jeder erfasste oder bearbeitete Schritt löst einen Aufruf an die KI aus, um die Aktion zu beschreiben. Die Kosten entsprechen denen einer normalen Schrittausführung; es gibt kein separates Aufzeichnungskontingent.
• Kein „Entwurfs“-Modus. Schritte werden sofort in der Testdefinition gespeichert, sobald die KI ihre Beschreibung zurückgibt. Wenn Sie sich entscheiden, dass Sie sie nicht möchten, bearbeiten oder löschen Sie sie – es gibt kein „Rollback“ für die gesamte Sitzung.
• XPath-Pre-Cache. Die Aufzeichnung füllt auch den XPath-Cache von msg.ZenTestAI, sodass der erste normale Lauf des Tests nach der Aufzeichnung einen KI-Elementidentifikationsaufruf pro aufgezeichnetem Schritt überspringt und schneller startet.