Workiva Support Center

Um eine Variable aus der Ausgabe eines Befehls zu erstellen, verwenden Sie dynamische Ausgaben. Dynamische Ausgaben sind Regeln, um einen Wert oder eine Liste von Werten aus der Ausgabe eines Befehls zu extrahieren, z. B. zur Verwendung in einer späteren Phase der Kette. Sie können mehrere dynamische Ausgaben zu einem Befehl hinzufügen:

• Eine exakte Übereinstimmung, basierend auf einem bestimmten Text am Anfang oder Ende der zu extrahierenden Werte
• Regulärer Ausdruck (regex), um Werte auf der Grundlage eines bestimmten Musters oder einer Sequenz abzugleichen

Wenn beispielsweise ein Befehl eine Textdatei mit Werten ausgibt, die in späteren Befehlen verwendet werden, extrahieren Sie diese Werte über eine dynamische Ausgabe für den File Utils connector's List File Content Befehl.

Hinweis: Dynamische Ausgaben haben eine maximale String-Übereinstimmungsgröße von 1024 Zeichen. Wenn die Übereinstimmung diese Länge überschreitet, wird nichts zurückgegeben.

Testen einer dynamischen Ausgabe

Um sicherzustellen, dass eine dynamische Ausgabe das gewünschte Ergebnis liefert, sollten Sie ihre Kriterien mit Beispielwerten testen, bevor Sie sie erstellen. Sie können zum Beispiel eine dynamische Ausgabe mit Telefonnummern testen:

(381) 782-5259 (511) 545-6132 (220) 476-8339 (837) 516-4312 

1. Wählen Sie in der Kette den Befehl mit der Ausgabe, aus der Sie extrahieren möchten, und klicken Sie auf Bearbeiten erstellen.
2. Wählen Sie Dynamic Outputs flash_on, und klicken Sie auf Test.
3. Geben Sie unter Value to test einen Beispielinhalt ein, der für die Befehlsausgabe bei dynamischer Ausgabe steht.
4. Geben Sie die Regex- oder exakten Übereinstimmungskriterien ein, die für die dynamische Ausgabe verwendet werden sollen. Zum Beispiel, um die Ortsvorwahlen aus den Beispieltelefonnummern zu extrahieren:
   • Wie Genaue Übereinstimmung:
     • Geben Sie in Anfang und Ende die öffnende und schließende Klammer ( und ) ein.
     • Um die Klammern in den extrahierten Wert einzubeziehen, wählen Sie Anfang einbeziehen und Ende einbeziehen.
   • Wie Regulärer Ausdruck (regex) übereinstimmen:
     • Geben Sie unter Match type den regulären Ausdruck \([0-9]*)\) ein, der auf Ziffern zwischen Klammern passt.
     • In Match result geben Sie $0 ein, um den gesamten übereinstimmenden Wert einschließlich der Klammern anzuzeigen, oder $1 für nur die übereinstimmenden Ziffern ohne die Klammern.
5. Klicken Sie auf Senden, und überprüfen Sie, ob die Ergebnisse mit der gewünschten Ausgabe übereinstimmen.

Erstellen einer dynamischen Ausgabe auf der Grundlage einer exakten Übereinstimmung

1. Wählen Sie in der Kette den Befehl mit der Ausgabe, aus der Sie extrahieren möchten, und klicken Sie auf Bearbeiten erstellen.
2. Wählen Sie Dynamic Outputs flash_on, und klicken Sie auf Add Dynamic Output.
3. Geben Sie einen eindeutigen Namen ein, um die dynamische Ausgabe zu identifizieren.
4. Wählen Sie unter Originalausgabe aus, aus welcher der Ausgaben des Befehls extrahiert werden soll.
5. In Match type, wählen Sie Exact.
6. Geben Sie den Text ein, der den Anfang oder das Ende der zu extrahierenden Zeichenfolgen angibt, und wählen Sie, ob der übereinstimmende Text in den extrahierten Wert aufgenommen werden soll.
7. Um nur Text in bestimmten Zeichenfolgen der Ausgabe zu finden, geben Sie die zu prüfenden Zeilen ein.
   • Um einen Bereich von Zeilen einzuschließen, verwenden Sie einen Bindestrich -, z. B. 1-10 für die Zeilen 1 bis 10.
   • Um Zeilen oder Bereiche zu trennen, verwenden Sie ein Komma ,, z. B. 1-10,13 für die Zeilen 1 bis 10 und Zeile 13.
8. Wählen Sie unter Ausgabetyp, ob Sie einen einzelnen Wert oder mehrere Werte extrahieren möchten.

   Hinweis: Ein Ausgabetyp von Multiple erstellt ein JSON-Array mit bis zu 1.000 Elementen, das Sie mit Befehls- oder Befehlsgruppeniterationen verwenden können.

9. Um die Groß- und Kleinschreibung beim Textabgleich zu berücksichtigen, wählen Sie Case sensitive.
10. Um führende oder abschließende Leerzeichen aus dem übereinstimmenden Text zu entfernen, wählen Sie Trim matches.
11. Klicken Sie auf Speichern.

Erstellen einer dynamischen Ausgabe auf der Grundlage eines regulären Ausdrucks

1. Wählen Sie in der Kette den Befehl mit der Ausgabe, aus der Sie extrahieren möchten, und klicken Sie auf Bearbeiten erstellen.
2. Wählen Sie Dynamic Outputs flash_on, und klicken Sie auf Add Dynamic Output.
3. Geben Sie einen eindeutigen Namen ein, um die dynamische Ausgabe zu identifizieren.
4. Wählen Sie unter Originalausgabe aus, aus welcher der Ausgaben des Befehls extrahiert werden soll.
5. Unter Match type wählen Sie Regular Expression (regex).
   
6. Geben Sie unter Match text die Regex-Syntax ein, die für die Übereinstimmung der zu extrahierenden Werte verwendet werden soll.
7. Geben Sie unter Match result die Syntax ein, wie der übereinstimmende Wert angezeigt werden soll. Zum Beispiel:
   • Für den gesamten abgeglichenen Wert geben Sie $0 ein.
   • Geben Sie für den in Klammern gesetzten übereinstimmenden Wert $1 ein.
8. Um nur Text in bestimmten Zeichenfolgen der Ausgabe zu finden, geben Sie die zu prüfenden Zeilen ein.
   • Um einen Bereich von Zeilen einzuschließen, verwenden Sie einen Bindestrich -, z. B. 1-10 für die Zeilen 1 bis 10.
   • Um Zeilen oder Bereiche zu trennen, verwenden Sie ein Komma ,, z. B. 1-10, 13 für die Zeilen 1 bis 10 und Zeile 13.
9. Wählen Sie unter Ausgabetyp, ob Sie einen einzelnen Wert oder mehrere Werte extrahieren möchten.

   Hinweis: Ein Ausgabetyp von Multiple erstellt ein JSON-Array mit bis zu 1.000 Elementen, das Sie mit Befehls- oder Befehlsgruppeniterationen verwenden können.

10. Klicken Sie auf Speichern.

Löschen einer dynamischen Ausgabe

So entfernen Sie eine dynamische Ausgabe aus einem Befehl:

1. Wählen Sie in der Kette den Befehl aus, aus dem die Ausgabe extrahiert werden soll, klicken Sie auf Bearbeiten Erstellen und wählen Sie Dynamische Ausgaben flash_on.
2. Klicken Sie für die zu entfernende dynamische Ausgabe auf Löschen löschen.