Workiva-ondersteuningscentrum

Om hun gebruik als opdrachtinvoer binnen een keten te vergemakkelijken, kunt u transformaties toepassen op een variabele of opdrachtuitvoer. U kunt meerdere transformaties toepassen op een opdrachtinvoer, bijvoorbeeld om de gegevens of de uitvoer van de transformatie verder te transformeren.

Transformaties

Opmerking: Wanneer u een JSON-uitvoer als eigenschap van een andere opdracht gebruikt, kunt u een specifiek element uit de uitvoer selecteren in plaats van de volledige JSON-string. Als u een element selecteert in plaats van de volledige tekenreeks, pas dan de Get Value from JSON transformatie toe om het gegevenstype te converteren.

Tekst als JSON parsen

Om een tekstvariabele of uitvoer naar JSON te converteren, past u de transformatie Parse Text as JSON toe:

1. Selecteer in de keten het knooppunt van de opdracht met de te transformeren invoer en klik op Bewerken  maken.
2. Klik onder Opdrachteigenschappenop de variabele of uitvoer die u wilt transformeren.
3. Selecteer Tekst parseren als JSON en klik op Toevoegen  toevoegen.

   Opmerking: Om ook een element uit de JSON op te halen, selecteert u Get Value from JSON en klikt u op   toevoegen om een extra transformatie toe te passen.

4. Klik op accepteren .

Het hoofdlettergebruik van een tekenreeks bijwerken

Om een tekststringvariabele of uitvoer te converteren naar hoofdletters of kleine letters, past u de transformatie Hoofdletters of Kleine letters toe:

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

1. Selecteer in de keten de opdracht met de te transformeren invoer en klik onder Opdrachteigenschappenop de te transformeren variabele of uitvoer.
<!--
2. Select whether to convert the string to Uppercase or Lowercase, and click Add&nbsp;&nbsp;add.
-->
3. Selecteer de transformatie die u wilt toepassen:
   • Om de eerste letter in elk woord van de tekenreeks een hoofdletter te geven, selecteert u Titleize.
   • Om de tekens van de tekenreeks om te zetten naar hoofdletters, selecteert u Hoofdletter of Hoofdletter.
   • Om de tekens van de tekenreeks om te zetten naar allemaal kleine letters, selecteert u Kleine letters.

   Opmerking: Om de string te transformeren, selecteert u de extra transformatie die u wilt toepassen en klikt u op   toevoegen.

4. Klik op accepteren .

Spaties aan het begin of einde van een tekenreeks toevoegen of verwijderen

Om spaties toe te voegen aan of te verwijderen van het begin of einde van een tekststringvariabele of uitvoer, past u een Pad of Trim transformatie toe:

1. Selecteer in de keten de opdracht met de te transformeren invoer en klik onder Opdrachteigenschappenop de te transformeren variabele of uitvoer.
2. Selecteer de transformatie die u wilt toepassen en klik op   toevoegen:
   • Om spaties toe te voegen aan het begin van de tekenreeks, selecteert u Links opvullen en voert u de totale lengte van de tekenreeks in.
   • Om spaties aan het einde van de tekenreeks toe te voegen, selecteert u Rechts opvullen en voert u de totale lengte van de tekenreeks in.
   • Om spaties aan het begin van de tekenreeks te verwijderen, selecteert u Voorvoegsel bijsnijden.
   • Om de spaties aan het einde van de tekenreeks te verwijderen, selecteert u Achtervoegsel bijsnijden.
   • Om spaties van zowel het begin als het einde van de tekenreeks te verwijderen, selecteert u Bijsnijden.

   Opmerking: Om de stringuitvoer te transformeren, selecteert u de extra transformatie die u wilt toepassen en klikt u op   toevoegen.

3. Selecteer accepteren.

Een tekenreeks splitsen

Om een tekststringvariabele of uitvoer te splitsen op basis van een begrenzingswaarde, past u de transformatie Splitsen toe:

1. Selecteer in de keten de opdracht met de te transformeren invoer en klik onder Opdrachteigenschappenop de te transformeren variabele of uitvoer.
2. Selecteer Splitsen en klik op Toevoegen  Toevoegen.
3. Voer voor Scheidingstekende tekstwaarde in waarbij de tekenreeks moet worden gesplitst.

   Opmerking: Om de stringuitvoer te transformeren, selecteert u de extra transformatie die u wilt toepassen en klikt u op   toevoegen.

4. Selecteer accepteren.

Een waarde in een tekenreeks vervangen

Om een waarde binnen een tekstvariabele of uitvoer door een andere waarde te vervangen, past u de transformatie Vervangen toe:

1. Selecteer in de keten de opdracht met de te transformeren invoer en klik onder Opdrachteigenschappenop de te transformeren variabele of uitvoer.
2. Selecteer Vervangen en klik op Toevoegen  toevoegen.
3. Voer in Zoekende criteria in van de waarde die moet worden vervangen in de tekenreeks als de exacte tekst die moet worden gematcht of een reguliere expressie.
4. Voer in Vervangingde waarde in om tekst te vervangen die overeenkomt met de criteria Zoeken .
5. Selecteer bij Type overeenkomstof u wilt zoeken naar de Vind criteria door middel van een Exacte overeenkomst of Reguliere expressie (RegEx).

   Opmerking: Om de stringuitvoer te transformeren, selecteert u de extra transformatie die u wilt toepassen en klikt u op   toevoegen.

6. Klik op accepteren .

Getallen optellen, aftrekken, vermenigvuldigen, delen of afronden

Om een wiskundige bewerking op een getalswaarde uit te voeren, past u een Optellen, Aftrekken, Vermenigvuldigen, Delen, of Afronden transformatie toe.

Tip: Om een wiskundige bewerking uit te voeren op een numerieke tekenreekswaarde, past u eerst een Parse number transformatie toe.

• Voer voor een Optellen of Aftrekken transformatie in met hoeveel u het getal wilt verhogen of verlagen.
• Voer voor een Vermenigvuldig of Deel transformatie in met hoeveel u het getal moet vermenigvuldigen of delen.
• Voor een Afronden transformatie voert u in naar hoeveel decimalen u het getal wilt afronden.

Parseer een datum of tijdstempel als een tekenreeks

Om een datum- of tijdstempelvariabele of uitvoer te converteren naar een specifiek formaat en tijdzone, past u de transformatie Parse Date/Time toe:

1. Selecteer in de keten de opdracht met de te transformeren invoer en klik onder Opdrachteigenschappenop de te transformeren variabele of uitvoer.
2. Selecteer Parse Date/Time en klik op Add  add.
3. Selecteer of u de standaardindeling van de International Organization for Standardization (ISO) of een aangepaste indeling met de datum of tijdstempel wilt gebruiken.
4. Voer in hoe u datum- of tijdwaarden kunt opmaken met behulp van strftime formats en scheidingstekens zoals ., ,, :, of /. Bijvoorbeeld %m-%d-%Y voor 01-30-2020, of %H:%M voor 21:08.
5. Om de tijdzone van de datum of tijdstempel te wijzigen, selecteert u de tijdzones voor de invoer- en uitvoerwaarden.

   Opmerking: Om de stringuitvoer te transformeren, selecteert u de extra transformatie die u wilt toepassen en klikt u op   toevoegen.

6. Klik op accepteren .

Een datum of tijdstempel toevoegen of aftrekken

Om een intervalwaarde toe te voegen aan of af te trekken van een datum- of tijdstempelvariabele of uitvoer, past u de transformatie Datum en tijd toevoegen/aftrekken toe:

1. Selecteer in de keten de opdracht met de te transformeren invoer en klik onder Opdrachteigenschappenop de te transformeren variabele of uitvoer.
2. Selecteer Datum en tijd toevoegen/aftrekken en klik op   toevoegen.
3. Selecteer of u de standaardindeling van de International Organization for Standardization (ISO) of wilt gebruiken..
4. Selecteer voor Bewerkingof u de tijdstempel wilt optellen of aftrekken.
5. Voer de verhoging in om toe te voegen aan of af te trekken van de tijdstempel, zoals 1 Dag.

   Opmerking: Om het formaat van de tijdstempel te wijzigen, selecteert u Parse Date/Time en klikt u op   toevoegen om een extra transformatie toe te passen.

6. Klik op accepteren .

Items in een lijst sorteren

Om de items in een lijstvariabele of uitvoer oplopend of aflopend te sorteren, past u de transformatie Sort List toe:

1. Selecteer in de keten de opdracht met de te transformeren invoer en klik onder Opdrachteigenschappenop de te transformeren variabele of uitvoer.
2. Selecteer Sorteerlijst en klik op Toevoegen  Toevoegen.
3. Selecteer of u de lijst oplopend of aflopend wilt sorteren.

   Opmerking: Om een tekenreekselement uit de lijst te kiezen, selecteert u Kies uit lijst en klikt u op   toevoegen om een extra transformatie toe te passen.

4. Klik op accepteren .

Elementen uit een lijst kiezen

Om een afzonderlijk element uit een lijstvariabele of uitvoer te extraheren, past u de transformatie Pick from List toe:

1. Selecteer in de keten de opdracht met de te transformeren invoer en klik onder Opdrachteigenschappenop de te transformeren variabele of uitvoer.
2. Selecteer Pick from List en klik op Add  add.
3. Voer voor Waardehet indexnummer in van het element dat u wilt kiezen; 0 voor het eerste element, -1 voor het laatste.

   Opmerking: Om het stringelement te transformeren, selecteert u de extra transformatie die u wilt toepassen en klikt u op   toevoegen.

4. Klik op accepteren .

Waarden ophalen uit JSON

Om een individueel element van een JSON-variabele of -uitvoer te converteren naar een string, lijst of JSON, past u de transformatie Get Value from JSON toe. Bij gebruik van de transformatie gebruiken elementen in een lijst binnen de JSON een op nul gebaseerde index, waarbij de eerste waarde een index heeft van 0.

Opmerking: Om de index en naam van het element te bepalen dat met de transformatie moet worden geparseerd, klikt u op Monitor  flight_takeoff, en bekijkt u de JSON-uitvoer van de opdracht.

1. Selecteer in de keten de opdracht met de te transformeren invoer en klik onder Opdrachteigenschappenop de te transformeren variabele of uitvoer.
2. Selecteer Get Value from JSON (Waarde uit JSON halen) en klik op Add  add. 
   
3. Selecteer of u het element wilt uitvoeren als een tekststring titel, lijst lijst, of JSON code.
4. Voer voor Waardein:
   • Als de JSON meerdere objecten bevat, voert u de index in van het object waaruit u wilt extraheren, beginnend met 0. Bijvoorbeeld, voor het tweede object voert u 1in.

     Opmerking: Voer de index alleen in als de JSON meerdere objecten bevat.

   • De naam van het te kiezen element, zoals id.

   Opmerking: Om de uitvoer van de transformatie te transformeren, bijvoorbeeld om een datumreeks op te maken of een lijst te sorteren, selecteert u de extra transformatie die u wilt toepassen en klikt u op   toevoegen.

5. Klik op accepteren .