Glossar
Diese Seite ist die zentrale Referenz (Single Source of Truth) dafür, wie wir Dinge in msg.ZenTestAI bezeichnen. Im Laufe der Zeit haben einige Konzepte mehr als einen Namen erhalten – dieselbe Entität erscheint als ein Wort in der Benutzeroberfläche, als ein anderes Wort in älteren Bildschirmen und als ein drittes in der API oder im Code. Diese Abweichung verwirrt Benutzer und den KI-Assistenten (der die API-Namen liest).
Jeder Eintrag unten nennt den kanonischen Begriff (verwenden Sie diesen überall – UI-Bezeichnungen, Dokumentationen, Support, MCP-Tool-Beschreibungen), die Synonyme, denen Sie möglicherweise noch begegnen, sowie den internen Namen / API-Namen, damit Entwickler die beiden zuordnen können. Wenn ein Begriff gefährlich überladen ist, weist der Eintrag darauf hin, womit er nicht verwechselt werden darf.
Wenn Sie einen Bildschirm, eine Dokumentationsseite, ein API-Feld oder ein MCP-Tool hinzufügen, verwenden Sie den kanonischen Begriff. Wenn Sie ein altes Synonym im Produkt finden, ziehen Sie es vor, dies zu beheben, anstatt es zu kopieren.
Das Frontend setzt dieses Glossar automatisch durch: msg-zen-test-ai-frontend/docs/Glossary.md
ist von dieser Seite abgeleitet, und Guard-Tests lassen den Frontend-Build fehlschlagen,
wenn ein verbotenes Synonym in einem UI-Text auftaucht.
Kern-Entitäten
| Kanonischer Begriff | Kanonischer Begriff (DE) | Was es ist | Synonyme, die Sie sehen könnten | Interner / API-Name |
|---|---|---|---|---|
| Test Case | Testfall | Ein Test in natürlicher Sprache: Header-Felder, eine geordnete Liste von Schritten, Parameter und Varianten. | "test", "test definition" | TestDefinition |
| Step | Schritt | Eine einzelne Anweisung in natürlicher Sprache innerhalb eines Testfalls. | — | TestStep |
| Activity | Aktivität | Eine benannte, zusammenhängende Gruppe von Schritten innerhalb eines Testfalls, die optional Metadaten für Schleifen / Bedingungen / Deaktivierung enthält. | — | activity (TestStep.activityId) |
| Execution Plan | Ausführungsplan | Ein ausführbares Paket, das Testfälle in Gruppen organisiert, deren Ausführungsreihenfolge steuert und Parameterwerte zwischen ihnen übergibt. Kann geplant oder über CI/CD ausgelöst werden. | "test set", "test plan" | TestSet |
| Group | Gruppe | Eine Ausführungsgruppe innerhalb eines Ausführungsplans – die Einheit, die die parallele/sequenzielle Reihenfolge steuert. | — | TestSetGroup |
| Folder | Ordner | Die Hierarchie, die die Listen-Seiten organisiert (Test-Cases, Snippets, Macros, Execution-Plans). Steht in keinem Zusammenhang mit den Gruppen eines Ausführungsplans. | — | TestGroup (das groupId-Feld) |
| Snippet | Snippet | Eine wiederverwendbare Sequenz von Schritten, auf die von anderen Testfällen aus verwiesen wird. | — | TestDefinition (Typ SNIPPET) |
| Macro | Makro | Eine kleine, wiederverwendbare Funktion (z. B. Datumsarithmetik), die innerhalb von Schritten verwendet werden kann. | — | macro |
| Script | Skript | Eine JavaScript-Funktion, die im Mandanten definiert und über die Scripts-Einstellung eines Schritts referenziert wird; dient der individuellen Testdaten-Erzeugung oder für Assertions. | "script function" | TestScriptDefinition |
| Tag | Tag | Ein frei vergebbares Label an einem Testfall, das zum Filtern von Listen und zum Steuern tag-basierter Gruppen innerhalb eines Ausführungsplans dient. | "label" | Tag |
| Execution | Ausführung | Eine tatsächliche Ausführung eines Testfalls oder Ausführungsplans mit Ergebnissen, Screenshots und Protokollen. | "run" | TestExecution |
Parameter & Varianten
| Kanonischer Begriff | Kanonischer Begriff (DE) | Was es ist | Synonyme, die Sie sehen könnten | Interner / API-Name |
|---|---|---|---|---|
| Parameter | Parameter | Ein benannter Platzhalter ([[name]]) im Text eines Schrittes, URL, etc., dessen Wert zur Laufzeit bereitgestellt wird. | — | parameter |
| Variant | Variante | Ein konkreter Satz von Parameterwerten, mit denen ein Testfall ausgeführt werden kann (plus optionaler Überschreibungen pro Ausführung). | "parameter combination", "combination" | ParameterCombination (combinationId) |
"Variante" ist der kanonische Begriff; combinationId bleibt als Name des API-Feldes für dasselbe Konzept bestehen. Wenn Sie combinationId lesen, denken Sie an Variante.
Personen, Agenten & KI — die große Überladung
Das Wort "agent" ist der am stärksten überladene Begriff im Produkt. Es bedeutet zwei völlig verschiedene Dinge, und sie dürfen niemals vermischt werden.
| Kanonischer Begriff | Kanonischer Begriff (DE) | Was es ist | Synonyme, die Sie sehen könnten | Interner / API-Name |
|---|---|---|---|---|
| Test User | Nutzer | Das Browser-Profil / die Identität, unter der ein Test ausgeführt wird: Auth-Modus, Viewport, Sprache, Zeitzone, Berechtigungen, Anmeldedaten. | "user", "agent" (veraltet), "browser role", "Testbenutzer" | Agent (das agentId-Feld) |
| AI Agent | KI-Agent | Eine der KI-Rollen, die einen Test steuert: Step-Agent, Login-Agent, XPath-Agent, Assertions-Agent, die Agentic AI, der Correction Agent. | — | (Prompt-Rollen im Runner) |
| AI Assistant | KI-Assistent | Der In-App-Chat, der einen Test über eine persistente, fortsetzbare Sitzung erstellt, repariert und analysiert. | — | agent session |
Ein Test User ist die Identität, unter der sich der Test anmeldet. Ein AI Agent ist die KI, die entscheidet, wohin geklickt werden soll. Sie stehen in keinem Zusammenhang. Die Entität hinter "Test User" heißt im Code und in der API nach wie vor Agent (agentId), was die historische Quelle der Verwirrung ist. Verwenden Sie gegenüber Benutzern überall die Bezeichnung Test User und reservieren Sie das bloße Wort "agent" für die KI-Rollen.
Mandantenfähigkeit & Konfiguration
| Kanonischer Begriff | Kanonischer Begriff (DE) | Was es ist | Synonyme, die Sie sehen könnten | Interner / API-Name |
|---|---|---|---|---|
| Tenant | Mandant | Ein isolierter Mandant: eigene Tests, Benutzer, Applikationen, Einstellungen und Daten. | "product" (erscheint in der API als Product) | Product |
| Application | Applikation | Ein konfiguriertes Zielsystem: Basis-Host/Pfad, Anmeldeverhalten, Proxy, KI-Hinweise, Iframe-Handhabung, etc. | "host", "enhanced application settings", "ProductHost", "Anwendung" | ProductHost |
| Application Map | Applikations-Übersicht | Eine visuelle Grafik der Bildschirme einer Applikation (Oberflächen) und der Abläufe dazwischen, erzeugt durch einen KI-Scan. | "app map", "Anwendungskarte", "Anwendungs-Map" | AppMap |
| Surface | Oberfläche | Ein Knoten in einer Applikations-Übersicht – eine Seite, ein Schritt in einem Ablauf oder ein Modal, das der scannende Agent erreicht hat. | — | AppMapNode |
Product ist der interne / API-Name für Mandant; das URL-Segment /tenant/... entspricht dem kanonischen Begriff. ProductHost ist ein interner Schemaname für Applikation – zeigen Sie keinen der beiden internen Namen den Benutzern an.
Qualitätssignale
| Kanonischer Begriff | Kanonischer Begriff (DE) | Was es ist | Synonyme, die Sie sehen könnten | Interner / API-Name |
|---|---|---|---|---|
| Flakiness | Flakiness | Wie oft ein Test bei unveränderter Definition zwischen bestanden und fehlgeschlagen wechselt (Sprunghaftigkeit), gemessen als Wechselrate (0–1) über die jüngsten Ergebnisse und angezeigt als Stabil / Flaky / Sehr flaky. Gemessen wird die Vertrauenswürdigkeit, nicht der Bestehen-/Fehlschlag-Zustand. | "flaky test", "intermittierender Test", "instabiler Test" | FlakinessDto (Wechselrate) |
Schreiben Sie es immer flakiness (ein Wort). Ein Ergebnis Stabil bedeutet konsistent, nicht fehlerfrei: Ein Test, der jedes Mal fehlschlägt, hat ebenfalls den Flakiness-Wert 0 (er wechselt nie). Der Stabilitäts-Streifen kennzeichnet diesen Fall gesondert, damit "Stabil" nie mit "besteht" verwechselt wird.
Kurze "Das verwenden, nicht das" Übersicht
| Verwenden Sie dies | Nicht das |
|---|---|
| Flakiness | flaky test · intermittierender Test · flakyness (Schreibfehler) |
| Testfall | test definition |
| Ausführungsplan | Testset · Test-Set · Test Set · Testsatz · Testplan |
| Variante | Kombination · parameter combination |
| Nutzer | Testbenutzer · Agent (wenn Sie die Anmeldeidentität meinen) |
| KI-Agent | Agent (nur die KI-Rollen sind "Agenten") |
| Applikation | Anwendung · host · ProductHost · application settings |
| Applikations-Übersicht | Anwendungskarte · Anwendungs-Map · app map |
| Skript | script function |
| Mandant | Tenant · product · Produkt |
| Ordner | Gruppe (Ordner organisieren Listen; Gruppen leben innerhalb eines Ausführungsplans) |