Centro assistenza di Workiva

Per facilitare il loro utilizzo come input di comando all'interno di una catena, puoi applicare delle trasformazioni a una variabile o a un output di comando. Puoi applicare più trasformazioni a un input di comando, ad esempio per trasformare ulteriormente i suoi dati o l'output della sua trasformazione.

Trasformazioni

Nota: Quando utilizzi un output JSON come proprietà di un altro comando, puoi selezionare un elemento specifico dall'output invece della stringa JSON completa. Se selezioni un elemento invece della stringa completa, applica la trasformazione Get Value from JSON per convertire il suo tipo di dati.

Parse text as JSON

Per convertire una variabile di testo o un output in JSON, applica la trasformazione Parse Text as JSON:

1. Nella catena, seleziona il nodo del comando con l'input da trasformare e clicca su Edit create.
2. In Command Properties, clicca sulla variabile o sull'output da trasformare.
3. Seleziona Parse text as JSON e clicca su Aggiungi Aggiungi.

   Nota: Per recuperare un elemento dal JSON, seleziona Get Value from JSON e clicca su Aggiungi Aggiungi per applicare una trasformazione aggiuntiva.

4. Clicca su Accetta.

Aggiornare la capitalizzazione di una stringa

Per convertire una variabile o un output di stringa di testo in maiuscolo o minuscolo, applica la trasformazione Maiuscolo o Minuscolo:

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

1. Nella catena, seleziona il comando con l'input da trasformare e, in Proprietà del comando, clicca sulla variabile o sull'output da trasformare.
<!--
2. Select whether to convert the string to Uppercase or Lowercase, and click Add&nbsp;&nbsp;add.
-->
3. Seleziona la trasformazione da applicare:
   • Per scrivere in maiuscolo la prima lettera di ogni parola della stringa, seleziona Titleize.
   • Per convertire i caratteri della stringa in tutte le maiuscole, seleziona Maiuscole o Maiuscole.
   • Per convertire i caratteri della stringa in tutte le minuscole, seleziona Minuscole.

   Nota: Per trasformare la stringa, seleziona la trasformazione aggiuntiva da applicare e clicca su Aggiungi Aggiungi.

4. Clicca su Accetta.

Aggiungi o rimuovi gli spazi intermedi o iniziali in una stringa

Per aggiungere o rimuovere spazi dall'inizio o dalla fine di una variabile o di un output di stringa di testo, applica una trasformazione Pad o Trim:

1. Nella catena, seleziona il comando con l'input da trasformare e, in Proprietà del comando, clicca sulla variabile o sull'output da trasformare.
2. Seleziona la trasformazione da applicare e clicca su Aggiungi Aggiungi:
   • Per aggiungere spazi iniziali all'inizio della stringa, seleziona Incolla a sinistra e inserisci la lunghezza totale della stringa.
   • Per aggiungere spazi finali alla fine della stringa, seleziona Incolla a destra e inserisci la lunghezza totale della stringa.
   • Per rimuovere gli spazi iniziali dall'inizio della stringa, seleziona Taglia prefisso.
   • Per rimuovere gli spazi residui dalla fine della stringa, seleziona Rifinisci Suffisso.
   • Per rimuovere gli spazi sia all'inizio che alla fine della stringa, seleziona Trim.

   Nota: Per trasformare la stringa in uscita, seleziona la trasformazione aggiuntiva da applicare e clicca su Aggiungi Aggiungi.

3. Seleziona Accetta.

Dividere una stringa

Per dividere una variabile o un output di stringa di testo in base a un valore di delimitatore, applica la trasformazione Dividi:

1. Nella catena, seleziona il comando con l'input da trasformare e, in Proprietà del comando, clicca sulla variabile o sull'output da trasformare.
2. Seleziona Dividi e clicca su Aggiungi Aggiungi.
3. Per Delimitatore, inserisci il valore di testo in cui dividere la stringa.

   Nota: Per trasformare la stringa in uscita, seleziona la trasformazione aggiuntiva da applicare e clicca su Aggiungi Aggiungi.

4. Seleziona Accetta.

Sostituire un valore in una stringa

Per sostituire un valore all'interno di una variabile di testo o di output con un altro valore, applica la trasformazione Replace:

1. Nella catena, seleziona il comando con l'input da trasformare e, in Proprietà del comando, clicca sulla variabile o sull'output da trasformare.
2. Seleziona Sostituisci e clicca su Aggiungi Aggiungi.
3. In Trova, inserisci i criteri del valore da sostituire nella stringa come testo esatto da abbinare o come espressione regolare.
4. In Replacement, inserisci il valore per sostituire il testo che corrisponde al criterio Find.
5. In Match Type, seleziona se cercare i criteri Find con una corrispondenza esatta o un'espressione regolare (RegEx).

   Nota: Per trasformare l'output della stringa, seleziona la trasformazione aggiuntiva da applicare e clicca su Aggiungi Aggiungi.

6. Clicca su Accetta.

Aggiungere, sottrarre, moltiplicare, dividere o arrotondare i numeri

Per eseguire un'operazione matematica su un valore numerico, applica una trasformazione Add, Subtract, Multiply, Divide, o Round.

Suggerimento: Per eseguire un'operazione matematica su un valore numerico di stringa, applica prima una trasformazione Parse number.

• Per una trasformazione Aggiungi o Sottrai, inserisci di quanto aumentare o diminuire il numero.
• Per una trasformazione Moltiplica o Dividi, inserisci di quanto moltiplicare o dividere il numero.
• Per una trasformazione Round, inserisci il numero di spazi decimali a cui arrotondare il numero.

Parsare una data o un timestamp come una stringa

Per convertire una variabile o un output di data o timestamp in un formato e un fuso orario specifici, applica la trasformazione Parse Date/Time:

1. Nella catena, seleziona il comando con l'input da trasformare e, in Proprietà del comando, clicca sulla variabile o sull'output da trasformare.
2. Seleziona Parse Date/Time e clicca su Aggiungi Aggiungi.
3. Seleziona se utilizzare il formato standard dell'Organizzazione Internazionale per la Standardizzazione (ISO) o un formato personalizzato per la data o il timestamp.
4. Indica come formattare i valori di data e ora usando i formati strftime e separatori come ., ,, :, o /. Ad esempio, %m-%d-%Y per 01-30-2020 o %H:%M per 21:08.
5. Per modificare il fuso orario della data o del timestamp, seleziona i fusi orari dei valori di input e di output.

   Nota: Per trasformare la stringa in uscita, seleziona la trasformazione aggiuntiva da applicare e clicca su Aggiungi Aggiungi.

6. Clicca su Accetta.

Aggiungere o sottrarre una data o un timestamp

Per aggiungere o sottrarre un valore di intervallo a o da una variabile o un output di data o timestamp, applica la trasformazione Add/Subtract Date and Time:

1. Nella catena, seleziona il comando con l'input da trasformare e, in Proprietà del comando, clicca sulla variabile o sull'output da trasformare.
2. Seleziona Aggiungi/Sottrai Data e Ora e clicca su Aggiungi Aggiungi.
3. Seleziona se utilizzare il formato standard dell'Organizzazione Internazionale per la Standardizzazione (ISO) o un formato personalizzato.
4. Per Operazione, seleziona se aggiungere o sottrarre il timestamp.
5. Inserisci l'incremento da aggiungere o sottrarre al timestamp, ad esempio 1 giorno.

   Nota: Per modificare il formato del timestamp, seleziona Parse Date/Time e clicca su Aggiungi Aggiungi per applicare una trasformazione aggiuntiva.

6. Clicca su Accetta.

Ordina gli elementi di un elenco

Per ordinare gli elementi di una variabile o di un output in ordine crescente o decrescente, applica la trasformazione Sort List:

1. Nella catena, seleziona il comando con l'input da trasformare e, in Proprietà del comando, clicca sulla variabile o sull'output da trasformare.
2. Seleziona Ordina elenco e clicca su Aggiungi Aggiungi.
3. Seleziona se ordinare l'elenco in ordine crescente o decrescente.

   Nota: Per scegliere un elemento di stringa dall'elenco, seleziona Scegli dall'elenco e clicca su Aggiungi Aggiungi per applicare una trasformazione aggiuntiva.

4. Clicca su Accetta.

Estrai elementi da un elenco

Per estrarre un singolo elemento da una variabile o da un'uscita di un elenco, applica la trasformazione Pick from List:

1. Nella catena, seleziona il comando con l'input da trasformare e, in Proprietà del comando, clicca sulla variabile o sull'output da trasformare.
2. Seleziona Scegli dall'elenco e clicca su Aggiungi Aggiungi.
3. Per Valore, inserisci il numero di indice dell'elemento da selezionare; 0 per il primo elemento, -1 per l'ultimo.

   Nota: Per trasformare l'elemento stringa, seleziona la trasformazione aggiuntiva da applicare e clicca su Aggiungi Aggiungi.

4. Clicca su Accetta.

Ottenere valori da JSON

Per convertire un singolo elemento da una variabile o da un output JSON in una stringa, un elenco o un JSON, applica la trasformazione Get Value from JSON. Quando si utilizza la trasformazione, gli elementi di un elenco all'interno del JSON utilizzano un indice basato su zero, dove il primo valore ha un indice di 0.

Nota: Per determinare l'indice e il nome dell'elemento da analizzare con la trasformazione, clicca su Monitor flight_takeoff e visualizza l'output JSON del comando.

1. Nella catena, seleziona il comando con l'input da trasformare e, in Proprietà del comando, clicca sulla variabile o sull'output da trasformare.
2. Seleziona Ottieni valore da JSON e clicca su Aggiungi Aggiungi. 
   
3. Seleziona se produrre l'elemento come stringa di testo titolo, elenco elenco, o JSON codice.
4. Per Valore, inserisci:
   • Se il JSON include più oggetti, l'indice dell'oggetto da cui estrarre, a partire da 0. Ad esempio, per il secondo oggetto , inserisci 1.

     Nota: Inserisci l'indice solo se il JSON include più oggetti.

   • Il nome dell'elemento da selezionare, ad esempio id.

   Nota: Per trasformare l'output della trasformazione, ad esempio per formattare una stringa di data o ordinare un elenco, seleziona la trasformazione aggiuntiva da applicare e clicca su Aggiungi Aggiungi.

5. Clicca su Accetta.