Einführung
Automatisierungsvariablen ermöglichen es Aktionen, innerhalb derselben Pipeline Daten aneinander weiterzugeben. Eine Aktion schreibt einen Wert in eine Variable – den Exit-Code eines Skripts, einen benutzerdefinierten Feldwert, ein Patch-Ergebnis – und eine spätere Aktion oder Bedingung liest diesen Wert.
Variablen sind auf die Automatisierung beschränkt, in der sie definiert wurden. Sie werden nicht zwischen Automatisierungen übertragen.
Automatisierungsvariablen erstellen
Es gibt zwei Möglichkeiten, eine Automatisierungsvariable zu erstellen.
Über den Reiter „Variablen"
Öffnen Sie eine Automatisierung und klicken Sie auf Variablen in der linken Seitenleiste.
Klicken Sie auf + Variable hinzufügen.
Geben Sie einen Namen (ohne Leerzeichen) und optional einen Standardwert ein.
Klicken Sie auf Speichern.
Hier erstellte Variablen sind sofort in allen Aktionen und Bedingungen der Automatisierung verfügbar.
Aus der Ausgabe einer Aktion
Jede Aktion kann ihre Ausgabe zur Laufzeit in eine Variable schreiben.
Öffnen Sie eine Aktion im Bearbeitungsmodus und scrollen Sie zu Weitere Optionen.
Geben Sie im Aktionsausgabe einer Variable zuweisen Feld einen Variablennamen ein oder wählen Sie eine vorhandene Variable aus.
Speichern Sie die Aktion.
ℹ️ HINWEIS: Dies ist derselbe Mechanismus, der durch das orangefarbene (x) Abzeichen auf Pipeline-Karten. Wenn Sie ein (x) Abzeichen an einer Aktion, liest oder schreibt diese Aktion eine Variable.
Variablen verwenden
In Aktionen und Skripten
Überall dort, wo das Rendern von Variablen unterstützt wird, klicken Sie auf das Variablensymbol, um eine Variable nach Namen einzufügen. Sie können die Referenz auch direkt mit der Doppel-Geschweifte-Klammer-Syntax eingeben:
{{MyVariable}}In Aktionsbedingungen
Variablen können in Aktionsbedingungen gelesen werden, um zu steuern, ob ein Schritt ausgeführt wird. Beispiel: Lösen Sie eine Aktion „Alarm erstellen" nur aus, wenn eine Variable mit dem Namen PatchingStatus gleich failed.
Siehe Aktionsbedingungen für die vollständige Referenz zu Bedingungstypen und Operatoren.
Zuordnung zu Skriptvariablen
Skriptvariablen sind benannte Ausgabe-Slots, die im Variablen Reiter. Das Skript schreibt während der Ausführung einen Wert in eine Skriptvariable, und die Zuordnung im Skript ausführen Aktionsbereich bestimmt, in welcher Automatisierungsvariable dieser Wert gespeichert wird – und ihn so für nachfolgende Aktionen und Bedingungen in der Pipeline verfügbar macht.
Skriptvariablen dienen der Erfassung von Ausgaben, nicht der Bereitstellung von Eingaben. Um Daten an an ein Skript (Gerätekontext, benutzerdefinierte Feldwerte, Systeminformationen) übergeben möchten, verwenden Sie Systemvariablen oder benutzerdefinierte Felder über das {x} Auswahlfeld im Skripteditor.
So ordnen Sie eine Skriptvariable einer Automatisierungsvariable zu:
Öffnen Sie die Skript ausführen Aktion im Bearbeitungsmodus.
Öffnen Sie im Skriptvariablen Abschnitt und suchen Sie die Skriptvariable, die Sie erfassen möchten.
Öffnen Sie das Automatisierungsvariablen Dropdown-Menü in dieser Zeile.
Wählen Sie eine vorhandene Automatisierungsvariable aus oder klicken Sie auf Neue Variable erstellen.
Wenn das Skript ausgeführt wird, wird der in die Skriptvariable geschriebene Wert in der zugeordneten Automatisierungsvariable gespeichert und durch die Pipeline weitergegeben.
ℹ️ HINWEIS: Der Abschnitt „Skriptvariablen" wird nur angezeigt, wenn das ausgewählte Skript mindestens eine Variable im zugehörigen Variablen-Reiter definiert hat.
Sie können eine Automatisierungsvariable auch inline aus einem Skript heraus setzen. Verwenden Sie die Inline- {{variable=value}} Syntax, wenn Ihr Skript andere Ausgaben erzeugt, die die Variable nicht verunreinigen sollen (Protokolle, Statusmeldungen usw.). Verwenden Sie Aktionsausgabe einer Variable zuweisen wenn die einzige Ausgabe des Skripts der zu erfassende Wert ist.
Fügen Sie dies an beliebiger Stelle in Ihrer Skriptausgabe ein:
{{variable_name=value}}Der Agent von Level analysiert die Skriptausgabe während der Ausführung auf dieses Muster. Alle anderen Ausgaben werden unverändert durchgeleitet. Die Variable muss zuvor noch im Variablen-Reiter des Skripts erstellt werden.
💡 TIPP: Dieses Muster – Ausgabe erfassen → in einer Bedingung prüfen – ist die Standardmethode zum Aufbau einer bedingten Fehlerbehandlung in Level. Siehe Automatisierungen erstellen für eine vollständige Anleitung zur Verwendung dieses Musters.
Häufig gestellte Fragen
Wo kann ich alle in einer Automatisierung verfügbaren Variablen einsehen? Öffnen Sie die Automatisierung und klicken Sie auf Variablen in der linken Seitenleiste. Hier werden alle für diese Automatisierung definierten Automatisierungsvariablen aufgelistet. Systemvariablen sind ebenfalls immer verfügbar, erscheinen hier jedoch nicht – siehe Systemvariablen für die vollständige Liste.
Kann ich denselben Variablennamen in mehreren Automatisierungen verwenden? Ja. Variablennamen sind auf die jeweilige Automatisierung beschränkt –
PatchingStatusin einer Automatisierung hat nichts mitPatchingStatusin einer anderen.Welchen Wert hat eine Variable, bevor eine Aktion in sie schreibt? Es wird der Standardwert verwendet, der beim Erstellen der Variable festgelegt wurde. Wenn kein Standardwert gesetzt wurde, ist sie leer.
Kann ich eine Variable aus einer vorherigen Automatisierungsausführung lesen? Nein. Variablen werden zu Beginn jeder Ausführung zurückgesetzt. Sie werden nicht zwischen Ausführungen gespeichert.