Verwendungsnachweise
Die meisten bearbeitbaren Entitäten in msg.ZenTestAI können von anderen Stellen referenziert werden – ein Snippet von vielen Tests, ein Makro von vielen Schritten, ein Skript von vielen Tests, ein Benutzer von vielen Tests und so weiter. Die Ansicht Verwendungsnachweise beantwortet die Frage "Wo wird das verwendet?" mit einem Klick.
Diese Seite ist die kanonische Beschreibung der Funktionsweise von Verwendungsnachweisen; entitätsspezifische Kapitel verweisen hierher, anstatt die Details zu wiederholen.
Wo sich der Button befindet
Bei unterstützten Entitäten befindet sich der Button Verwendungsnachweise im Header des Editors (typischerweise in der rechten Seitenleiste, die sich öffnet, wenn Sie auf eine Zeile in einer Liste klicken). Das genaue Symbol und die Beschriftung variieren je nach Editor leicht, aber die Funktion ist dieselbe.
| Entität | Verwendungsnachweise verfügbar? |
|---|---|
| Test Cases | ✅ |
| Snippets | ✅ |
| Macros | ✅ |
| Scripts | ✅ |
| Files | ✅ |
| Users | ✅ |
| Application Settings hosts | ✅ |
| Execution Plans | ❌ |
| AI Models, External Systems | ❌ |
Der Button ist immer verfügbar – Sie müssen nicht erst versuchen, etwas zu löschen, um ihn zu sehen. Die Liste, die er anzeigt, entspricht genau der Menge an Referenzen, die das System verwendet, um zu entscheiden, ob eine Löschung blockiert werden soll, nur eben proaktiv bereitgestellt.
Was das Popover anzeigt
Ein Klick auf den Button öffnet ein kleines Popover mit einer Zeile pro Verwendung:
- ein Typ-Symbol, das anzeigt, welche Art von Element die Entität referenziert (Test, Plan, Host, …),
- der Name des referenzierenden Elements als Link – ein Klick auf die Zeile führt Sie direkt zu diesem Element,
- eine kurze Beziehungsbezeichnung (z. B. "In Test verwendet", "Im Ausführungsplan enthalten", "Nutzer in Test verwendet"),
- ein Anzahl-Badge, wenn dasselbe Element die Entität an mehr als einer Stelle referenziert (z. B. ein Makro, das in drei verschiedenen Schritten desselben Tests verwendet wird).
Wenn nichts die Entität referenziert, zeigt das Popover einen leeren Zustand an.
Was nachverfolgt wird
Die folgenden Beziehungen werden derzeit erkannt:
- Tests → Snippets — jeder Schritt, der ein Snippet referenziert.
- Tests → Makros — jeder
${=macro(...)}-Aufruf in Schrittbeschreibungen und Parameterwerten. - Tests → Ausführungspläne — jeder Test, der in einem Plan enthalten ist.
- Tests → Benutzer / Agent — der dem Test zugewiesene Benutzer (und gegebenenfalls Überschreibungen pro Schritt).
- Tests → Skript — jede Skript-Funktionsreferenz aus einem Schritt.
- Tests → Datei — jede Datei, die für Upload/Download referenziert wird.
- Tests → Applikationseinstellungen-Host — das Host-Profil, an das der Test gebunden ist.
Das Öffnen der Verwendungsnachweise für ein Snippet, Makro, Skript, eine Datei, einen Benutzer oder Host listet also die Tests auf, die darauf verweisen. Das Öffnen bei einem Test listet die Ausführungspläne auf, die den Test enthalten.
Berechtigungen und Sichtbarkeit
Der Button ist für jeden verfügbar, der den Editor der Entität öffnen kann – es gibt keine separate Berechtigung dafür. Es gelten die gleichen Regeln zum Mandanten-Geltungsbereich: Sie sehen nur Referenzen von Elementen innerhalb Ihres eigenen Mandanten.
Zusammenhang mit dem Löschen
Das Löschen einer Entität, die noch referenziert wird, kann je nach Entität blockiert werden oder eine Warnung auslösen. Das Popover für Verwendungsnachweise ist die empfohlene Methode, um die Referenzen zuerst zu finden und zu bereinigen – das ist deutlich angenehmer, als sie erst durch einen blockierten Löschdialog zu entdecken.