Einführung
Automatisierungsvariablen ermöglichen es Aktionen, innerhalb derselben Pipeline Daten aneinander weiterzugeben. Eine Aktion schreibt einen Wert in eine Variable – einen Exit-Code eines Skripts, den Wert eines benutzerdefinierten Felds, ein Patch-Ergebnis – und eine spätere Aktion oder Bedingung liest diesen aus.
Variablen sind auf die Automatisierung beschränkt, in der sie definiert werden. 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 Variables in der linken Seitenleiste.
Klicken Sie auf + Add variable.
Geben Sie einen Namen (ohne Leerzeichen) und einen optionalen Standardwert ein.
Klicken Sie auf Save.
Hier erstellte Variablen sind sofort in allen Aktionen und Bedingungen der Automatisierung verfügbar.
Über die Ausgabe einer Aktion
Jede Aktion kann ihre Ausgabe zur Laufzeit in eine Variable schreiben.
Öffnen Sie eine Aktion im Bearbeitungsmodus und scrollen Sie zu Additional options.
Geben Sie im Assign action output to variable Feld einen Variablennamen ein oder wählen Sie eine vorhandene aus.
Speichern Sie die Aktion.
ℹ️ HINWEIS: Dies ist derselbe Mechanismus, der durch das orangefarbene (x) Badge auf Pipeline-Karten. Wenn Sie ein (x) Badge auf einer Aktion sehen, 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 ausgelesen werden, um zu steuern, ob ein Schritt ausgeführt wird. Beispiel: Eine Aktion „Alert erstellen" soll nur ausgelöst werden, wenn eine Variable mit dem Namen PatchingStatus gleich failed.
Siehe Action Conditions für die vollständige Referenz zu Bedingungstypen und Operatoren.
Zuordnung zu Skriptvariablen
Skriptvariablen sind benannte Ausgabe-Slots, die im Variables Reiter. Das Skript schreibt während der Ausführung einen Wert in eine Skriptvariable, und die Zuordnung im Run Script Aktionsbereich bestimmt, welche Automatisierungsvariable diesen Wert speichert – und ihn 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 in ein Skript (Gerätekontext, Werte benutzerdefinierter Felder, Systeminformationen), verwenden Sie Systemvariablen oder benutzerdefinierte Felder über das {x} Auswahlfeld im Skripteditor.
So ordnen Sie eine Skriptvariable einer Automatisierungsvariable zu:
Öffnen Sie die Run Script Aktion im Bearbeitungsmodus.
Im Script variables Abschnitt und suchen Sie die Skriptvariable, die Sie erfassen möchten.
Öffnen Sie das Automation variables Dropdown in dieser Zeile.
Wählen Sie eine vorhandene Automatisierungsvariable aus oder klicken Sie auf Create new variable.
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 in seinem Reiter „Variables" definiert hat.
Sie können eine Automatisierungsvariable auch inline direkt aus einem Skript heraus setzen. Verwenden Sie die Inline- {{variable=value}} Syntax, wenn Ihr Skript weitere Ausgaben erzeugt, die die Variable nicht verunreinigen sollen (Logs, Statusmeldungen usw.). Verwenden Sie Assign action output to variable wenn die einzige Ausgabe des Skripts der Wert ist, den Sie erfassen möchten.
Fügen Sie dies an beliebiger Stelle in Ihre Skriptausgabe ein:
{{variable_name=value}}Level's Agent durchsucht die Skriptausgabe während der Ausführung nach diesem Muster. Alle anderen Ausgaben werden unverändert durchgeleitet. Die Variable muss zuvor noch im Reiter „Variables" des Skripts erstellt worden sein.
💡 TIPP: Dieses Muster – Ausgabe erfassen → in einer Bedingung prüfen – ist der Standardweg, um eine bedingte Fehlerbehandlung in Level zu implementieren. Siehe Building Automations für eine vollständige Anleitung zur Verwendung dieses Musters.
FAQ
Wo kann ich alle in einer Automatisierung verfügbaren Variablen einsehen? Öffnen Sie die Automatisierung und klicken Sie auf Variables in der linken Seitenleiste. Dort werden alle für diese Automatisierung definierten Automatisierungsvariablen aufgelistet. Systemvariablen sind ebenfalls immer verfügbar, erscheinen hier jedoch nicht – siehe System Variables 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. Wurde kein Standardwert gesetzt, ist die Variable leer.
Kann ich eine Variable aus einem vorherigen Automatisierungsdurchlauf auslesen? Nein. Variablen werden zu Beginn jedes Durchlaufs zurückgesetzt. Sie bleiben nicht zwischen Durchläufen erhalten.