Workiva Support Center

Befehle sind die Aufgaben, die innerhalb der Kette auf der Grundlage einer Verbindung mit einer Datenquelle ausgeführt werden. Bei komplexeren Ketten kann dies Befehle umfassen, die durch eine Vielzahl von Bedingungen ausgelöst werden.

Hinweis: Bevor Sie eine Kette hinzufügen, vergewissern Sie sich, dass Ihre Organisation die Verbindungen einrichtet, die erforderlich sind, um Befehle mit ihren Datenquellen zu aktivieren.

Um bestimmte Befehle seriell- einer nach dem anderen, wobei jeder auf die Beendigung des vorherigen Befehls wartet - oder gleichzeitig parallel auszuführen, oder um eine Kette fehlschlagen zu lassen, wenn einer von mehreren Befehlen fehlschlägt, gruppieren Sie sie.

Hinzufügen eines Befehls zu einer Kette

1. Wählen Sie in der Kette den auszuführenden Befehl aus:
   • Um der Kette einen neuen Befehl hinzuzufügen, klicken Sie unter Available Connectors auf die entsprechende Verbindung und verschieben Sie den Befehl an die Stelle, an der er in der Kette erscheinen soll.
   • Um einen vorhandenen Befehl zu duplizieren, markieren Sie seinen Knoten, klicken Sie auf Copy file_copy und verschieben Sie den neuen Knoten an die Stelle, an der er in der Kette erscheinen soll.

   Tipp: Um einen Befehl als ersten Knoten der Kette hinzuzufügen, verschieben Sie ihn nach Start.

2. Um den Befehl mit dem vorherigen und dem nächsten Knoten in der Kette zu verbinden, klicken Sie auf die Anschlüsse des Knotens und ziehen Sie eine Linie zwischen ihnen.

   Hinweis: Um die Position eines Knotens in der Kette zu ändern, heben Sie die Verknüpfung mit anderen Knoten auf und verschieben Sie ihn dann an die Stelle, an der er erscheinen soll. Um mehrere Knoten auf einmal zu verschieben, halten Sie SHIFT gedrückt, während Sie sie auswählen.

3. Markieren Sie den neuen Knoten, und klicken Sie auf Bearbeiten erstellen.
4. Geben Sie die Parameter des Befehls ein:
   • Geben Sie unter Basic Info einen eindeutigen Namen und eine Beschreibung ein, um den Befehl und seinen Zweck zu identifizieren.
   • Schalten Sie das Augensymbol ein, wenn Sie sensible Daten ausblenden möchten.
   • Um den Befehl mehrfach auszuführen, aktivieren Sie für jedes Element in der Liste Iteratorrepeat, und geben Sie die Iterationswerte ein.
   • Unter Befehlseigenschaften geben Sie die Eingänge des Befehls ein, basierend auf dem Anschluss.
5. Klicken Sie auf Speichern.

Nur einen einzelnen Befehl oder eine Gruppe ausführen

Um Tests und schnelle Iterationen bei der Erstellung von Ketten zu erleichtern, können Sie einen einzelnen Befehl oder eine Befehlsgruppe innerhalb einer Kette ausführen.

1. Wählen Sie im Chain Builder auf der Registerkarte Chains die Option Execute flight_takeoff aus dem Menü der Kette.
2. Klicken Sie für den auszuführenden Befehl oder die Gruppe auf Diesen Befehl ausführen play_circle_outline.
3. Klicken Sie auf Run Chain.

Einen Befehl überspringen

Um eine Verzweigungslogik zu entwickeln oder als Teil einer Kette, müssen Sie möglicherweise einen Befehl überspringen, um ein bestimmtes Ergebnis zu erzwingen. Sie können auch eine bedingte Logik einrichten, um auf der Grundlage festgelegter Regeln automatisch ein bestimmtes Ergebnis zu erhalten.

1. Markieren Sie in der Kette den Knoten des Befehls, klicken Sie auf Bearbeiten Erstellen, und wählen Sie Überspringenskip_next.
2. Wählen Sie, ob automatisch ein Ergebnis von info check_circle, warning warning, oder error error für den Befehl zurückgegeben werden soll, wenn er übersprungen wird.
3. Um den Befehl nur dann zu überspringen, wenn bestimmte Kriterien erfüllt sind, geben Sie an, wann. Bauen Sie die bedingte Logik als Gruppe auf, zu der Sie Regeln und andere Gruppen von Regeln hinzufügen, die jeweils mit einem booleschen UND oder ODER verknüpft sind.
   • Wenn alle Bedingungen erfüllt sein müssen, um übersprungen zu werden, wählen Sie AND.
   • Wenn nur eine Bedingung erfüllt sein muss, um übersprungen zu werden, wählen Sie OR.

   Sie können Regeln auf der Grundlage verschiedener Datentypen hinzufügen:

   Datentyp	Beschreibung
   Zeichenfolge	Zwei oder mehr Zeichen
   Ganzzahl	Jeder ganze, nicht dezimale numerische Wert
   Datum	Beliebige Datumszeichenfolge oder Datumsvariable
   Float	Beliebiger numerischer Wert
   JSON	JavaScript Object Notation; Verwendung von Variablentransformation zum Parsen von Objekten

   Um zu überprüfen, ob die Daten die Kriterien zum Überspringen des Befehls erfüllen, verbinden Sie sie mit einem Operator und einem Wert:

   • Ist leer oder Ist nicht leer
   • Enthält
   • Entspricht RegExp, für regulären Ausdruck
   • Beginnt mit oder Endet mit
   • = oder !=
   • < oder >
   • <= oder >=
4. Klicken Sie auf Speichern.

Verwalten der Fehlerbehandlung eines Befehls

So erkennen oder ignorieren Sie Fehler für einen Befehl:

1. Klicken Sie in der Kette auf den Knoten des Befehls, klicken Sie auf Bearbeiten Erstellen, und wählen Sie Fehlerbehandlung Warnung.
2. Wählen Sie unter Fehleraktionen wiederholen, was zu tun ist, wenn der Befehl fehlschlägt.
   
   • Um der Logik der Kettenverzweigung zu folgen, wählen Sie Weiter mit Kette.
   • Um die Kette vorübergehend anzuhalten, z. B. um das Problem zu beheben, wählen Sie Kette anhalten. Um die Kette neu zu starten, nachdem das Problem behoben wurde, wählen Sie den Befehl in der Kette aus und klicken Sie auf Resume.
   • Um die Kette vollständig zu beenden, wählen Sie Kette beenden.
3. Um den Befehl zu stoppen, wenn er länger dauert, als er sollte, geben Sie unter Zeitüberschreitungsbedingungen  alarm die maximale Dauer in Sekunden ein.
   
4. Um einen Befehl zu wiederholen, wenn seine Datenquelle unterbrochen oder nicht verfügbar ist, geben Sie die Anzahl der Wiederholungsversuche ein und wie viele Sekunden zwischen den Versuchen gewartet werden soll.
5. Wählen Sie unter Fehlerbedingungen priority_high alle Fehler aus, die ignoriert werden sollen, z. B. wenn ein bereits vorhandener Ordner erstellt wird.
6. Um den Status des Befehls auf der Grundlage seiner Ausgabe festzulegen, klicken Sie auf Fügen Sie unter Ausgabeinterpretation, und definieren Sie die Regel – oder die Gruppe von Regeln – zur Interpretation seines Status.  Mit der Variablen Status der Ausgabe Command Details können Sie beispielsweise eine Regel festlegen, die eine Warnung ausgibt, wenn der Befehl erfolgreich ausgeführt wurde.
   
7. Wählen Sie unter Protokollinterpretation aus, ob der Befehl fehlschlagen soll, je nachdem, ob er zu bestimmten Ausgaben führt.
   • Um nicht den Befehl auf der Grundlage bestimmter Ausgaben fehlschlagen zu lassen, wählen Sie Nicht interpretieren.
   • Um den Befehl fehlschlagen zu lassen, wenn bestimmte Ausgänge gefunden werden, wählen Sie Fehlschlagen, wenn Ausgang (Ausgänge) gefunden wird (werden) und geben Sie die Ausgänge ein, nach denen gesucht werden soll.
   • Um den Befehl fehlschlagen zu lassen, wenn bestimmte Ausgaben nicht gefunden werden, wählen Sie Fehlschlagen, wenn Ausgabe(n) nicht gefunden und geben Sie die zu suchende Ausgabe ein.
   • Mehrere Textzeilen müssen durch folgende Zeichen voneinander getrennt werden \n
8. Klicken Sie auf Speichern.

Anzeigen der Ausgabe eines Befehls

Unter Monitorflight_takeoff können Sie eine Vorschau der Ausgabe eines über den CloudRunner ausgeführten Befehls anzeigen. 

1. Öffnen Sie in Chain Builder, in Monitor den Lauf mit der Ausgabe zur Vorschau und wählen Sie den Befehl.
2. Klicken Sie auf der Registerkarte Ausgaben auf Vorschau der AusgabeSichtbarkeit für die zu betrachtende Ausgabe.
   

Hinweis: Sie können nur eine Vorschau der Ausgaben von Befehlen sehen, die über den CloudRunner ausgeführt wurden, nicht einen GroundRunner.

Einen Befehl aus einer Kette entfernen

Um einen Befehl aus einer Kette zu entfernen, klicken Sie auf den entsprechenden Knoten, klicken Sie auf Löschen löschen, und klicken Sie dann auf Löschen.

Hinweis: Um die Logik der Kette zu gewährleisten, können Sie einen Befehl nicht löschen, wenn sein übergeordneter Befehl mehrere Geschwister oder Zweige auf der gleichen Ebene hat.