Workiva Support Center

Um ihre Verwendung als Befehlseingänge innerhalb einer Kette zu erleichtern, können Sie Transformationen auf eine Variable oder einen Befehlsausgang anwenden. Sie können mehrere Transformationen auf eine Befehlseingabe anwenden, z. B. um ihre Daten oder die Ausgabe ihrer Transformation weiter zu transformieren.

Verwandlungen

Hinweis: Wenn Sie eine JSON-Ausgabe als Eigenschaft eines anderen Befehls verwenden, können Sie ein bestimmtes Element aus der Ausgabe anstelle des vollständigen JSON-Strings auswählen. Wenn Sie ein Element anstelle der vollständigen Zeichenfolge auswählen, wenden Sie die Transformation Wert aus JSON holen an, um den Datentyp zu konvertieren.

Text als JSON parsen

Um eine Textvariable oder eine Ausgabe in JSON zu konvertieren, wenden Sie die Transformation Parse Text as JSON an:

1. Wählen Sie in der Kette den Knoten des Befehls mit der zu transformierenden Eingabe und klicken Sie auf Bearbeiten  erstellen.
2. Klicken Sie unter Command Propertiesauf die zu transformierende Variable oder Ausgabe.
3. Wählen Sie Text als JSON analysieren, und klicken Sie auf Hinzufügen  hinzufügen.

   Hinweis: Um auch ein Element aus dem JSON abzurufen, wählen Sie Get Value from JSON und klicken Sie auf Add  add , um eine zusätzliche Transformation anzuwenden.

4. Klicken Sie auf Akzeptieren Sie.

Aktualisierung der Großschreibung einer Zeichenkette

Um eine Textstring-Variable oder -Ausgabe in Groß- oder Kleinbuchstaben zu konvertieren, wenden Sie die Transformation Großbuchstaben oder Kleinbuchstaben an:

To title-case a text string variable or output or convert its characters to all uppercase or lower-case:-->

1. Wählen Sie in der Kette den Befehl mit der zu transformierenden Eingabe und klicken Sie unter Command Propertiesauf die zu transformierende Variable oder Ausgabe.
<!--
2. Select whether to convert the string to Uppercase or Lowercase, and click Add&nbsp;&nbsp;add.
-->
3. Wählen Sie die Transformation aus, die Sie anwenden möchten:
   • Um den ersten Buchstaben in jedem Wort der Zeichenkette groß zu schreiben, wählen Sie Überschrift schreiben.
   • Um die Zeichen der Zeichenfolge in Großbuchstaben umzuwandeln, wählen Sie Großbuchstaben oder Großschreiben.
   • Um die Zeichen der Zeichenfolge in Kleinbuchstaben umzuwandeln, wählen Sie Kleinbuchstaben.

   Hinweis: Um die Zeichenfolge zu transformieren, wählen Sie die zusätzliche Transformation aus, die Sie anwenden möchten, und klicken Sie auf Hinzufügen  .

4. Klicken Sie auf Akzeptieren Sie.

Hinzufügen oder Entfernen von Leerzeichen am Ende oder Anfang einer Zeichenkette

Um Leerzeichen am Anfang oder Ende einer Textstring-Variablen oder -Ausgabe hinzuzufügen oder zu entfernen, wenden Sie eine Pad oder Trim Transformation an:

1. Wählen Sie in der Kette den Befehl mit der zu transformierenden Eingabe und klicken Sie unter Command Propertiesauf die zu transformierende Variable oder Ausgabe.
2. Wählen Sie die anzuwendende Transformation aus, und klicken Sie auf Add  add:
   • Um führende Leerzeichen am Anfang der Zeichenkette hinzuzufügen, wählen Sie Links auffüllen und geben die Gesamtlänge der Zeichenkette ein.
   • Um Leerzeichen am Ende der Zeichenfolge hinzuzufügen, wählen Sie Rechts auffüllen und geben Sie die Gesamtlänge der Zeichenfolge ein.
   • Um führende Leerzeichen am Anfang der Zeichenkette zu entfernen, wählen Sie Präfix abschneiden.
   • Um Leerzeichen am Ende der Zeichenkette zu entfernen, wählen Sie Suffix abschneiden.
   • Um Leerzeichen sowohl am Anfang als auch am Ende der Zeichenfolge zu entfernen, wählen Sie Schneiden.

   Hinweis: Um die String-Ausgabe zu transformieren, wählen Sie die zusätzliche Transformation aus, die Sie anwenden möchten, und klicken Sie auf Add  add.

3. Wählen Sie Akzeptieren Sie.

Eine Zeichenkette aufteilen

Um eine Textstring-Variable oder -Ausgabe auf der Grundlage eines Begrenzungswertes aufzuteilen, wenden Sie die Transformation Aufteilen an:

1. Wählen Sie in der Kette den Befehl mit der zu transformierenden Eingabe und klicken Sie unter Command Propertiesauf die zu transformierende Variable oder Ausgabe.
2. Wählen Sie Teilen, und klicken Sie auf Hinzufügen  Hinzufügen.
3. Geben Sie unter Delimiterden Textwert ein, an dem die Zeichenfolge geteilt werden soll.

   Hinweis: Um die String-Ausgabe zu transformieren, wählen Sie die zusätzliche Transformation aus, die Sie anwenden möchten, und klicken Sie auf Add  add.

4. Wählen Sie Akzeptieren Sie.

Ersetzen eines Wertes in einer Zeichenkette

Um einen Wert innerhalb einer Textvariablen oder -ausgabe durch einen anderen Wert zu ersetzen, wenden Sie die Transformation Replace an:

1. Wählen Sie in der Kette den Befehl mit der zu transformierenden Eingabe und klicken Sie unter Command Propertiesauf die zu transformierende Variable oder Ausgabe.
2. Wählen Sie Ersetzen, und klicken Sie auf Hinzufügen  hinzufügen.
3. Geben Sie unter Finddie Kriterien für den zu ersetzenden Wert in der Zeichenfolge als genauen Text oder als regulären Ausdruck ein.
4. Geben Sie unter Ersetzungden Wert ein, der den Text ersetzen soll, der den Kriterien Suchen entspricht.
5. Wählen Sie unter Match Typeaus, ob Sie nach den Kriterien Find mit einer exakten Übereinstimmung oder einem regulären Ausdruck (RegEx) suchen möchten.

   Hinweis: Um die String-Ausgabe zu transformieren, wählen Sie die zusätzliche Transformation aus, die Sie anwenden möchten, und klicken Sie auf Add  add.

6. Klicken Sie auf Akzeptieren Sie.

Zahlen addieren, subtrahieren, multiplizieren, dividieren oder runden

Um eine mathematische Operation mit einem Zahlenwert durchzuführen, wenden Sie eine Addieren, Subtrahieren, Multiplizieren, Dividierenoder Runden Transformation an.

Tipp: Um eine mathematische Operation an einem numerischen Zeichenfolgenwert durchzuführen, wenden Sie zunächst eine Transformation Parse number an.

• Für eine Addieren oder Subtrahieren Umwandlung, geben Sie ein, um wie viel die Zahl erhöht oder verringert werden soll.
• Für eine Transformation Multiplizieren oder Dividieren geben Sie ein, um wie viel die Zahl multipliziert oder dividiert werden soll.
• Für eine Rundung Transformation geben Sie an, auf wie viele Dezimalstellen die Zahl gerundet werden soll.

Parsen eines Datums oder Zeitstempels als String

Um eine Datums- oder Zeitstempelvariable oder eine Ausgabe in ein bestimmtes Format und eine bestimmte Zeitzone zu konvertieren, wenden Sie die Transformation Parse Date/Time an:

1. Wählen Sie in der Kette den Befehl mit der zu transformierenden Eingabe und klicken Sie unter Command Propertiesauf die zu transformierende Variable oder Ausgabe.
2. Wählen Sie Datum/Uhrzeit analysieren, und klicken Sie auf Hinzufügen  hinzufügen.
3. Wählen Sie, ob Sie das Standardformat der Internationalen Organisation für Normung (ISO) oder ein benutzerdefiniertes Format für das Datum oder den Zeitstempel verwenden möchten.
4. Geben Sie ein, wie Sie Datums- oder Zeitwerte mit strftime-Formaten und Trennzeichen wie ., ,, :oder /formatieren können. Zum Beispiel: %m-%d-%Y für den 30.01.2020 oder %H:%M für 21:08.
5. Um die Zeitzone des Datums oder Zeitstempels zu ändern, wählen Sie die Zeitzonen für die Eingabe- und Ausgabewerte.

   Hinweis: Um die String-Ausgabe zu transformieren, wählen Sie die zusätzliche Transformation aus, die Sie anwenden möchten, und klicken Sie auf Add  add.

6. Klicken Sie auf Akzeptieren Sie.

Addieren oder Subtrahieren eines Datums oder Zeitstempels

Um einen Intervallwert zu einer Datums- oder Zeitstempelvariablen oder -ausgabe zu addieren oder davon zu subtrahieren, wenden Sie die Transformation Add/Subtract Date and Time an:

1. Wählen Sie in der Kette den Befehl mit der zu transformierenden Eingabe und klicken Sie unter Command Propertiesauf die zu transformierende Variable oder Ausgabe.
2. Wählen Sie Datum und Uhrzeit hinzufügen/subtrahieren, und klicken Sie auf hinzufügen  hinzufügen.
3. Wählen Sie aus, ob Sie den Standard der Internationalen Organisation für Normung (ISO) oder ein benutzerdefiniertes Formatverwenden möchten.
4. Unter Operationkönnen Sie auswählen, ob der Zeitstempel addiert oder subtrahiert werden soll.
5. Geben Sie die Schrittweite ein, die zum Zeitstempel addiert oder von ihm subtrahiert werden soll, z. B. 1 Tag.

   Hinweis: Um das Format des Zeitstempels zu ändern, wählen Sie Datum/Uhrzeit analysieren und klicken Sie auf Hinzufügen  hinzufügen , um eine zusätzliche Transformation anzuwenden.

6. Klicken Sie auf Akzeptieren Sie.

Elemente in einer Liste sortieren

Um die Elemente in einer Listenvariablen oder -ausgabe in aufsteigender oder absteigender Reihenfolge zu sortieren, wenden Sie die Transformation Sort List an:

1. Wählen Sie in der Kette den Befehl mit der zu transformierenden Eingabe und klicken Sie unter Command Propertiesauf die zu transformierende Variable oder Ausgabe.
2. Wählen Sie Liste sortieren, und klicken Sie auf Hinzufügen  hinzufügen.
3. Wählen Sie aus, ob die Liste in aufsteigender oder absteigender Reihenfolge sortiert werden soll.

   Hinweis: Um ein Zeichenkettenelement aus der Liste auszuwählen, wählen Sie Aus Liste auswählen und klicken Sie auf Hinzufügen  hinzufügen , um eine zusätzliche Transformation anzuwenden.

4. Klicken Sie auf Akzeptieren Sie.

Elemente aus einer Liste auswählen

Um ein einzelnes Element aus einer Listenvariablen oder -ausgabe zu extrahieren, wenden Sie die Transformation Pick from List an:

1. Wählen Sie in der Kette den Befehl mit der zu transformierenden Eingabe und klicken Sie unter Command Propertiesauf die zu transformierende Variable oder Ausgabe.
2. Wählen Sie "Aus Liste auswählen", und klicken Sie auf Hinzufügen  hinzufügen.
3. Für Wert, geben Sie die Indexnummer des zu wählenden Elements ein; 0 für das erste Element, -1 für das letzte.

   Hinweis: Um das String-Element zu transformieren, wählen Sie die zusätzliche Transformation aus, die angewendet werden soll, und klicken Sie auf Add  add.

4. Klicken Sie auf Akzeptieren Sie.

Werte aus JSON abrufen

Um ein einzelnes Element aus einer JSON-Variable oder -Ausgabe in eine Zeichenkette, Liste oder JSON zu konvertieren, wenden Sie die Transformation Get Value from JSON an. Bei der Verwendung der Transformation. verwenden Elemente in einer Liste innerhalb des JSON einen nullbasierten Index, wobei der erste Wert einen Index von 0hat.

Hinweis: Um den Index und den Namen des Elements zu ermitteln, das mit der Transformation analysiert werden soll, klicken Sie auf Monitor  flight_takeoff, und sehen Sie sich die JSON-Ausgabe des Befehls an.

1. Wählen Sie in der Kette den Befehl mit der zu transformierenden Eingabe und klicken Sie unter Command Propertiesauf die zu transformierende Variable oder Ausgabe.
2. Wählen Sie Get Value from JSON, und klicken Sie auf Add  add. 
   
3. Wählen Sie, ob das Element als Text-String title, Liste listoder JSON codeausgegeben werden soll.
4. Für Werteingeben:
   • Wenn die JSON-Datei mehrere Objekte enthält, geben Sie den Index des Objekts ein, von dem aus extrahiert werden soll, beginnend mit 0. Für das zweite Objekt geben Sie beispielsweise 1ein.

     Hinweis: Geben Sie den Index nur ein, wenn das JSON mehrere Objekte enthält.

   • Der Name des zu wählenden Elements, z. B. id.

   Hinweis: Um die Ausgabe der Transformation umzuwandeln, z. B. um eine Datumszeichenfolge zu formatieren oder eine Liste zu sortieren, wählen Sie die zusätzliche Transformation aus, die Sie anwenden möchten, und klicken Sie auf Add  add.

5. Klicken Sie auf Akzeptieren Sie.