Testfall-Definition

Übersicht

Ein Testfall ist in die folgenden Reiter unterteilt:

Reiter	Details
Allgemein	Titel, URL, Benutzer/Rolle, Ordner, Tags und weitere Metainformationen über den Test (siehe Allgemein unten).
Schritte	Die eigentliche Definition des Testfalls — die Schritte, die die KI-Agenten ausführen werden.
Varianten	Optionale Parameterkombinationen, die aus einem Test viele Durchläufe mit unterschiedlichen Daten machen. Siehe Parameter und Testdaten.
Letzte Läufe	Die letzten Ausführungen des Testfalls, mit Status und Links zu den Ausführungsdetails.
Änderungshistorie	Revisionsprotokoll jeder Änderung an der Testdefinition (wer hat was wann geändert).
KI-Assistent	Eingebettete KI-Assistenten-Sitzungen für diesen Test — nützlich, um den Assistenten zu bitten, den Test zu erweitern, zu debuggen oder zu erklären (nur bei gespeicherten Tests verfügbar).

Die Reiter Änderungshistorie, Letzte Läufe und KI-Assistent erscheinen erst, nachdem ein Test gespeichert wurde — sie sind im Erstellungs-/Kopiermodus ausgeblendet. Der Reiter Varianten ist für Snippets ausgeblendet.

Für die Erstellung von Schritten gibt es drei Möglichkeiten:

• Manuell via Prompting: Schreiben Sie den Testfall in natürlicher Sprache im Reiter Schritte.
• Aufzeichnung: Zeichnen Sie den Testfall über die Schaltfläche Test aufzeichnen in der Kopfzeile auf. Weitere Details finden Sie im Abschnitt Aufzeichnung.
• Import: Schreiben Sie den Testfall in einem externen Tool und importieren/synchronisieren Sie ihn mit msg.ZenTestAI. Siehe Externe Systeme.
• Mit KI erstellen / Per KI importieren: Generieren Sie den Test aus einer Unterhaltung mit dem KI-Assistenten oder aus einer eingefügten Beschreibung / einem hochgeladenen Dokument. Siehe Testfall-Übersicht.

Allgemein

Der Reiter „Allgemein“ sammelt alle Metainformationen über den Test — das Was, Wo und Wer. Nur Titel, Start-URL und Benutzer / Rolle sind obligatorisch; alles andere ist optional, hilft aber bei Organisation und Ausführung.

Die Felder in der Reihenfolge ihrer Anzeige:

• Titel — der Name des Testfalls. Erforderlich. Hat keinen Einfluss auf die Ausführung selbst.

• Beschreibung — Freitextbeschreibung. Optional, kein Einfluss auf die Ausführung.

• Start-URL des Tests — die URL, die der Browser vor dem ersten Schritt öffnet. Unterstützt Parameter-Platzhalter wie [[parameterName]] (siehe Parameter und Testdaten) sowie Makros für Query- und Pfadparameter. Zwei Symbole neben dem Feld ermöglichen das schnelle Hinzufügen oder Bearbeiten der Anwendungseinstellungen für diese URL.

  tipp

  Verhalten pro URL (Timeouts, Scrolling, benutzerdefinierte Wartezeiten, Schritte vor/nach dem Login, …) wird unter Zusätzliche Funktionen → Anwendungseinstellungen konfiguriert und automatisch basierend auf der URL des Tests angewendet.

• Benutzer / Rolle — der Akteur, der den Testfall ausführt. Erforderlich. Das Dropdown listet Benutzer/Rollen auf, die im Abschnitt Benutzer & Rollen definiert sind. Das Stift-Symbol neben dem Feld öffnet einen Inline-Editor, damit Sie einen Benutzer/eine Rolle anpassen oder erstellen können, ohne den Test zu verlassen.

• Ordner — der Ordner, zu dem dieser Test gehört. Optional. Ordner sind hierarchisch und werden als Breadcrumb angezeigt (z. B. Region › Versicherung › Formulare). Verwenden Sie die Symbole neben dem Feld, um den ausgewählten Ordner zu bearbeiten oder einen neuen Inline-Ordner zu erstellen. Siehe Ordner für die vollständige Beschreibung der Ordner-UX.

• Skript-Funktionen — JavaScript-Funktionen, auf die Sie aus den Testschritten verweisen können (z. B. für benutzerdefinierte Datengenerierung oder Assertionen). Siehe Skripting.

• Tags — freie Labels zur Kategorisierung von Tests. Die Auswahl vervollständigt automatisch bereits im Mandanten verwendete Tags, aber Sie können einen neuen Wert eingeben, um einen zu erstellen. Tags werden für die Filterung in der Testfall-Übersicht und den Ausführungsplänen verwendet und haben keinen Einfluss auf die Ausführung selbst.

• Login erforderlich — Schalter, der am Anfang des Tests einen automatischen Login-Schritt einfügt. Der Schalter wird automatisch gesetzt, wenn Sie einen Benutzer / eine Rolle mit konfigurierter Authentifizierung wählen, aber Sie können ihn manuell überschreiben. Siehe Login-Ablauf für die Konsequenzen.

• Bei fehlgeschlagenen HTTP-Anfragen fehlschlagen — wenn aktiviert, wird der Test als fehlgeschlagen markiert, wenn eine Hintergrund-HTTP-Anfrage einen Serverfehler-Status (HTTP 5xx) zurückgibt. Nützlich für das Monitoring: Es erkennt technische Fehler, die für einen Benutzer, der durch die UI klickt, möglicherweise nicht sichtbar sind.

• Erweiterte Anwendungseinstellungen — wählt ein Host-Profil aus den Anwendungseinstellungen aus, das auf diesen Lauf angewendet werden soll. Das Dropdown enthält nur Werte, wenn Host-Profile für den Mandanten konfiguriert sind.

• Testdaten synchronisieren — nur sichtbar, wenn der Test von Jira XRay importiert wurde und mit diesem verknüpft ist und das Xray-Ticket Testdaten enthält. Wenn aktiviert, werden die Testdaten (Parameterkombinationen) bei jedem Speichern aus Xray synchronisiert.

Kopfzeilen-Schaltflächen

Die Kopfzeile der Testdetailseite bietet testbezogene Aktionen:

• Link zu externem System verwalten (Kettensymbol) — den Test mit einem konfigurierten externen System verknüpfen oder das verknüpfte Ticket im Quell-Tool öffnen. Wird nur angezeigt, wenn mindestens ein externes System für den Mandanten konfiguriert ist. Siehe Externe Systeme.
• Exportieren (Upload-Symbol) — den Test als JSON oder Text exportieren.
• Test aufzeichnen — eine interaktive Aufzeichnungssitzung starten, die Ihre Klicks und Eingaben als Testschritte erfasst. Siehe Aufzeichnung.
• Test ausführen — den Test jetzt ausführen. Wenn der Test Varianten hat, werden Sie gefragt, welche Kombination(en) ausgeführt werden sollen.
• Weitere Aktionen (⋮) — ein Kebab-Menü mit sekundären Aktionen, einschließlich Verwendungsnachweisen für den Test.

Bei Tests, die mit einem externen System verknüpft sind, zeigt die Kopfzeile auch die Quellsystem-ID (ein anklickbarer Link für Jira/XRay) sowie Aktionen zum Synchronisieren und Verknüpfung aufheben — siehe Externe Systeme → Sperren, Verknüpfungen aufheben und Konflikte.

Fußzeilen-Schaltflächen

Die Fußzeile ist fest am unteren Rand der Seite platziert:

• Speichern — Änderungen dauerhaft speichern. Bei Tests, die mit Xray verknüpft sind, ändert sich die Schaltfläche in Synchronisieren und Speichern, wenn ausstehende Änderungen vorliegen, die an Xray übertragen werden müssen.
• Test löschen — den Test dauerhaft löschen, einschließlich aller seiner Ausführungen. Das Löschen kann nicht rückgängig gemacht werden.

hinweis

Die Speichern-Aktion ist auch mit dem Tastaturkürzel Strg+s belegt.

Schreibgeschützte Felder für importierte Tests

Wenn der Test von einem externen System (Jira XRay oder Zephyr) importiert wurde und mit diesem verknüpft ist, werden Titel, Beschreibung und Schritte schreibgeschützt — das externe System ist das Master-System dafür. Alle anderen Felder im Reiter „Allgemein“ bleiben bearbeitbar. Verwenden Sie die Aktion Verknüpfung aufheben in der Kopfzeile, um die Synchronisation des Tests zu beenden und alle Felder wieder bearbeitbar zu machen.

Snippets

Wenn der Testtyp ein Snippet ist, unterscheidet sich der Reiter „Allgemein“ leicht:

• Tags und Bei fehlgeschlagenen HTTP-Anfragen fehlschlagen sind ausgeblendet.
• Start-URL und Benutzer / Rolle erscheinen nur, wenn Login erforderlich aktiviert ist (Snippets erben diese normalerweise vom aufrufenden Test).
• Ein zusätzlicher Isoliert-Schalter erscheint, wenn Login erforderlich aktiviert ist. Mit aktivierter Isolierung läuft das Snippet in einer flüchtigen Browsersitzung: Cookies und lokaler Speicher werden vor dem Snippet-Lauf als Schnappschuss gespeichert und danach wiederhergestellt. Verwenden Sie dies, wenn sich das Snippet als ein anderer Benutzer anmelden muss als der übergeordnete Test.

Schritte

Innerhalb des Bereichs „Schritte“ können Sie Ihren tatsächlichen Testfall definieren. Bitte beziehen Sie sich auf das Kapitel Prompting, um zu verstehen, wie und welche Art von Schritten Sie in natürlicher Sprache schreiben können. Für jeden Schritt können Sie den Prompt für die KI und optional zusätzliche Einstellungen definieren.

Über das Burger-Menü direkt neben dem Schritt können Sie folgende Aktionen ausführen:

• Erklären: Erklärt, wie die KI-Agenten Ihre Schrittbeschreibung verstehen.
• Kopieren: Den Schritt duplizieren.
• Erweitert: Öffnet die erweiterten Einstellungen in der Seitenleiste für den Schritt.

Prompting / Aktionen

Obwohl Sie die Funktionen der natürlichen Sprache voll nutzen können, versteht msg.ZenTestAI manche Arten von Testbeschreibungen besser als andere. Für die besten Ergebnisse lesen Sie bitte den Abschnitt Prompting.

Erweiterte Einstellungen

Sie können erweiterte Einstellungen für einen Schritt in der Seitenleiste definieren.

Einstellung	Beschreibung
Kommentar	Ein Kommentar für den Schritt. Dies dient nur Dokumentationszwecken und hat keinen Einfluss auf die Testausführung.
Schritt deaktivieren	Deaktiviert den Schritt. Der Schritt wird nicht ausgeführt. Falls Sie diesen Schalter setzen, können Sie auch eine boolesche Variable definieren. Wenn die Variable wahr ist, wird der Schritt nicht ausgeführt. Diese Option ist sehr nützlich, um Schritte basierend auf Parametern auszuführen.
Schlussfolgerung (Reasoning)	Sie können eine verbesserte Schlussfolgerung für diesen Schritt aktivieren. Wenn Sie diese Option aktivieren, validiert ein zusätzlicher bildbasierter Anbieter das vom DOM-basierten Agenten identifizierte Element und liefert zusätzliches Feedback / versucht es erneut, falls er glaubt, dass das ausgewählte Feld falsch war. Dies verlangsamt den Testfortschritt, kann aber helfen, Halluzinationen bei komplexen Schritten zu reduzieren.
KI-Modell für Schrittausführung	Definiert eines der im Mandanten definierten KI-Modelle, das bei der Ausführung des Schritts verwendet werden soll. Dies überschreibt die Standardwerte der Mandanteneinstellungen. Diese Einstellung ist besonders hilfreich, wenn Sie normalerweise ein kostengünstiges Modell verwenden möchten, aber für einen bestimmten Schritt ein leistungsfähigeres Modell benötigen.
Dateien (Upload/Download)	Dateien, die dem Schritt zugewiesen sind. Erforderlich, wenn Sie im Schritt Datei-Uploads oder -Downloads anfordern möchten. Siehe Prompting für weitere Details.
Skripte	JavaScript-Funktionen, die innerhalb der Testfalldefinition verwendet werden können. Siehe Abschnitt Skripting für weitere Informationen.
Zusätzliche Wartezeiten vor/nach Schritt erzwingen	Erzwingt zusätzliche Wartezeiten vor oder nach dem Schritt (in ms). Dies kann nützlich sein, wenn Sie einen Schritt haben, der mehr Zeit zur Ausführung benötigt. Hinweis: Normalerweise ist automatisches Warten ausreichend. Verwenden Sie diese Option mit Vorsicht, da sie die Testausführung verlängert.
XPath dieses Schritts	Definieren Sie explizit den XPath für den Schritt. Dies ist nützlich, wenn der KI-Agent das richtige Element nicht findet. Hinweis: Sie verlieren die Flexibilität von msg.ZenTestAI, wenn Sie den XPath definieren. Mit Vorsicht verwenden.
XPath des übergeordneten Elements	Definieren Sie explizit einen Sektions-XPath, für den der Schritt relevant ist. Dies ist nützlich, wenn Sie einen sehr statischen Bereich haben, in dem der KI-Agent nach dem Element suchen soll. Dies verringert die Laufzeit, da sich der KI-Agent auf einen kleineren Bereich konzentrieren kann. Hinweis: Sie verlieren die Flexibilität von msg.ZenTestAI, wenn Sie den XPath definieren. Mit Vorsicht verwenden.
Zusätzliche Anweisungen für KI	Zusätzliche Anweisungen für den KI-Agenten. Dies kann verwendet werden, um dem KI-Agenten mehr Kontext über den Schritt zu geben.

tipp

Bei der Anwendung erweiterter Einstellungen ist es am besten, eine Eins-zu-eins-Beziehung zwischen Ihrem Schritt in natürlicher Sprache und dem auszuführenden Schritt zu haben. Beispiel: Sie definieren einen XPath, den der Schritt verwenden soll. Der Schritt ist definiert als: „Klicke auf Button A und dann auf Button B“. In diesem Fall wird der XPath für beide Buttons verwendet, was möglicherweise nicht das gewünschte Verhalten ist.