Verwendungsreferenzen
Die meisten editierbaren Entitäten in msg.ZenTestAI können von anderen Stellen aus referenziert werden — ein Snippet in vielen Tests, ein Makro in vielen Schritten, ein Skript in vielen Tests, ein Benutzer in vielen Tests und so weiter. Die Ansicht Verwendungsreferenzen beantwortet die Frage "Wo wird dies verwendet?" mit einem einzigen Klick.
Diese Seite ist die kanonische Beschreibung der Funktionsweise von Verwendungsreferenzen; entitätsspezifische Kapitel verlinken hierher, anstatt die Details zu wiederholen.
Wo sich die Schaltfläche befindet
Bei unterstützten Entitäten befindet sich die Schaltfläche Verwendungsreferenzen 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 Bezeichnung variieren je nach Editor leicht, aber die Funktion ist dieselbe.
| Entität | Verwendungsreferenzen verfügbar? |
|---|---|
| Test Cases | ✅ |
| Snippets | ✅ |
| Macros | ✅ |
| Scripts | ✅ |
| Files | ✅ |
| Users | ✅ |
| Application Settings hosts | ✅ |
| Execution Plans | ❌ |
| AI Models, Externe Systeme | ❌ |
Die Schaltfläche ist immer verfügbar — Sie müssen keinen Löschvorgang einleiten, um sie zu sehen. Die Liste, die sie anzeigt, enthält dieselben Referenzen, die das System verwendet, um zu entscheiden, ob ein Löschvorgang blockiert werden soll; sie wird hier lediglich proaktiv bereitgestellt.
Was das Popover anzeigt
Ein Klick auf die Schaltfläche ö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,
- ein kurzes Beziehungs-Label (z. B. "verwendet in Test", "enthalten im Testset", "Agent des Tests"),
- 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 die Entität nirgendwo referenziert wird, zeigt das Popover einen leeren Zustand an.
Was wird nachverfolgt
Die folgenden Beziehungen werden derzeit erkannt:
- Tests → Snippets — jeder Schritt mit Snippet-Referenz.
- Tests → Macros — jeder
${=macro(...)}-Aufruf in Schrittbeschreibungen und Parameterwerten. - Tests → Execution Plans — jeder in einem Plan enthaltene Test.
- Tests → User / Agent — der dem Test zugewiesene Benutzer (und ggf. Überschreibungen pro Schritt).
- Tests → Script — jede Skript-Funktionsreferenz aus einem Schritt.
- Tests → File — jede für Upload/Download referenzierte Datei.
- Tests → Application Settings host — das Host-Profil, an das der Test gebunden ist.
Wenn Sie also Verwendungsreferenzen für ein Snippet, Makro, Skript, eine Datei, einen Benutzer oder einen Host öffnen, werden die Tests aufgelistet, die darauf verweisen. Wenn Sie dies bei einem Test tun, werden die Execution Plans aufgelistet, die den Test enthalten.
Berechtigungen und Sichtbarkeit
Die Schaltfläche steht jedem zur Verfügung, der den Editor der Entität öffnen kann — es gibt keine separate Berechtigung dafür. Es gelten dieselben Regeln für den Produktumfang: Sie sehen nur Referenzen von Elementen innerhalb Ihres eigenen Tenants.
Beziehung zum 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 Verwendungsreferenzen ist der empfohlene Weg, um zuerst die Referenzen zu finden und zu bereinigen — das ist deutlich angenehmer, als dies erst durch einen blockierten Löschdialog zu erfahren.