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, stellen Sie sicher, dass Ihre Organisation die Verbindungen einrichtet, die für die Aktivierung von Befehlen mit ihren Datenquellen erforderlich sind.

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, wählen Sie dessen Knoten aus, klicken Sie auf Kopieren file_copy und verschieben Sie den neuen Knoten an die gewünschte Position in der Chain.

   Tipp: Um einen Befehl als ersten Knoten der Kette hinzuzufügen, verschieben Sie ihn auf 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. Wählen Sie den neuen Knoten aus und klicken Sie auf Bearbeiten create.
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 in Chain Builder im Tab Chains im Menü der Chain Ausführen flight_takeoff aus.
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. Wählen Sie in der Chain den Knoten des Befehls aus, klicken Sie auf Bearbeiten create und wählen Sie Überspringenskip_next aus.
2. Wählen Sie aus, ob für den übersprungenen Befehl automatisch ein Ergebnis vom Typ Info check_circle, Warnung warning oder Fehler error zurückgegeben werden soll.

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 Chain auf den Knoten des Befehls, klicken Sie auf Bearbeiten create und wählen Sie Fehlerbehandlung warning aus.
2. Wählen Sie unter Fehleraktionen repeat aus, was geschehen soll, 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 als vorgesehen dauert, geben Sie unter Timeout-Bedingungen 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 Fehler aus, die ignoriert werden sollen, zum Beispiel beim Erstellen eines bereits vorhandenen Ordners.
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 die Ausgaben von Befehlen anzeigen, die über den CloudRunner ausgeführt werden, nicht einen GroundRunner.

Einen Befehl aus einer Kette entfernen

Um einen Befehl aus einer Chain zu entfernen, klicken Sie auf dessen Knoten, klicken Sie auf Löschen delete und 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.