Zum Hauptinhalt springen
Aktionen

Tag hinzufügen oder entfernen

Wie die Aktion Tag hinzufügen oder entfernen ein Geräte-Tag setzt oder entfernt – immer oder abhängig von einer Bedingung.

Mit Tag hinzufügen oder entfernen setzt du ein Tag an einem Gerät oder entfernst es wieder – immer oder abhängig von einer Bedingung. So hältst du zum Beispiel ein Tag, das den Zustand eines Geräts beschreibt, automatisch aktuell. Das Gerät muss dafür nicht online sein.

Konfigurationsfelder

FeldTypPflichtStandardBeschreibung
AktionAuswahlJaTag hinzufügenTag hinzufügen oder Tag entfernen führt genau das aus. Bei Nach Bedingung hinzufügen oder entfernen entscheidet das Feld Tag hinzufügen, wenn … – andernfalls entfernen
TagTextJa—Das Tag, um das es geht, zum Beispiel wartung. Unterstützt Variablen ${{ … }}. Ohne Tag lässt sich die Automatisierung nicht speichern
Zielgerät (optional)TextNeinleer (Dieses Gerät)Lass das Feld leer, um das Gerät der Ausführung zu taggen. Sonst gibst du eine Geräte-ID ein oder fügst eine Variable ein, die eine enthält. Gerätenamen funktionieren nicht
Tag hinzufügen, wenn … – andernfalls entfernenBedingungJa, bei Nach Bedingung hinzufügen oder entfernen—Nur bei Nach Bedingung hinzufügen oder entfernen sichtbar. Zeilen, die eine Variable mit einem Wert vergleichen, verknüpft mit Alle oder Beliebige – genau wie bei einer Schrittbedingung. Trifft die Bedingung zu, kommt das Tag dazu, sonst wird es entfernt

Die Tag-Bedingung ist nicht dasselbe wie die allgemeine Bedingung des Schritts. Die allgemeine Bedingung legt fest, ob der Schritt überhaupt läuft. Ist sie nicht erfüllt, wird der Schritt übersprungen und das Tag bleibt, wie es ist. Willst du ein Tag nur in bestimmten Fällen hinzufügen und sonst in Ruhe lassen, nimm Tag hinzufügen mit einer allgemeinen Bedingung.

Plattformunterstützung

Die Aktion läuft in octoja und funktioniert auf jedem Betriebssystem gleich.

Ausgaben

AusgabeBeschreibung
tagDas Tag mit aufgelösten Variablen
matchedtrue, wenn der Schritt das Tag hinzufügen soll, false, wenn er es entfernen soll
actionAktion: added, removed oder unchanged

Ergebnisverhalten

Der Schritt kümmert sich nur um Tags, die von Hand gesetzt wurden. Ein gleichnamiges Tag aus einer Tag-Regel entfernt er nie, und es zählt auch nicht als vorhanden. Der Schritt kann also ein manuelles Tag daneben setzen. Groß- und Kleinschreibung spielen keine Rolle: Wartung gilt als das vorhandene Tag wartung.

SituationErgebnis
Das Tag soll hinzugefügt werden, und das Gerät hat es noch nichtErfolgreich, action = added
Das Tag soll entfernt werden, und das Gerät hat esErfolgreich, action = removed
Das Tag ist schon im gewünschten ZustandErfolgreich, action = unchanged
Tag ist nach dem Auflösen leerFehlgeschlagen: „Für den Schritt zum Hinzufügen/Entfernen eines Tags wurde kein Tag angegeben.“
Zielgerät (optional) ist keine gültige Geräte-IDFehlgeschlagen: „Das Zielgerät konnte nicht in eine gültige Geräte-ID aufgelöst werden.“
Das Zielgerät existiert nicht oder wurde gelöschtFehlgeschlagen: „Das Zielgerät wurde nicht gefunden.“

Du kannst den Schritt gefahrlos mehrfach ausführen: Er ändert das Gerät nur, wenn sich am Tag wirklich etwas ändern muss. Eine Variable, die octoja nicht auflösen kann, bleibt als wörtlicher Text im Tag-Namen stehen.

Geräte-Tags (trigger.deviceTags) in Bedingungen werden beim Start der Ausführung festgehalten. Fügt dieser Schritt ein Tag hinzu oder entfernt es, sehen spätere Schritte derselben Ausführung davon nichts.

Siehe auch: Eine Automatisierung erstellen · Tag-Regeln konfigurieren