Centro assistenza di Workiva

Per facilitarne l'uso come input di comando all'interno di una catena, è possibile applicare trasformazioni a una variabile o a un output di comando. È possibile applicare più trasformazioni a un comando in ingresso, ad esempio per trasformare ulteriormente i dati o l'output della trasformazione.

Trasformazioni

Nota: Quando si utilizza un output JSON come proprietà di un altro comando, è possibile selezionare un elemento specifico dall'output invece della stringa JSON completa. Se si seleziona un elemento invece della stringa completa, applicare la trasformazione Ottieni valore da JSON per convertire il tipo di dati.

Analizzare il testo come JSON

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

1. Nella catena, selezionare il nodo del comando con l'input da trasformare e fare clic su Editcreate.
2. In Command Properties, fare clic sulla variabile o sull'output da trasformare.
3. Selezionate Parse text as JSON e fate clic su Addadd.

   Nota: Per recuperare anche un elemento dal JSON, selezionare Get Value from JSON e fare clic su Addadd per applicare un'ulteriore trasformazione.

4. Fare clic su Accettare.

Aggiornare la capitalizzazione di una stringa

Per convertire una variabile o un output di stringa di testo in tutte le maiuscole o le minuscole, applicare la trasformazione Uppercase o Lowercase:

1. Nella catena, selezionare il comando con l'input da trasformare e, in Proprietà del comando, fare clic sulla variabile o sull'output da trasformare.
2. Selezionare la trasformazione da applicare:
   • Per scrivere in maiuscolo la prima lettera di ogni parola della stringa, selezionare Titleize.
   • Per convertire i caratteri della stringa in tutte le maiuscole, selezionare Maiuscole o Maiuscole.
   • Per convertire i caratteri della stringa in tutte le minuscole, selezionare Minuscole.

   Nota: Per trasformare la stringa, selezionare la trasformazione aggiuntiva da applicare e fare clic su Aggiungereaggiungere.

3. Fare clic su Accettare.

Aggiungete o rimuovete gli spazi finali o iniziali di una stringa

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

1. Nella catena, selezionare il comando con l'input da trasformare e, in Proprietà del comando, fare clic sulla variabile o sull'output da trasformare.
2. Selezionare la trasformazione da applicare e fare clic su Aggiungereaggiungere:
   • Per aggiungere spazi iniziali all'inizio della stringa, selezionare Pad Left e inserire la lunghezza totale della stringa.
   • Per aggiungere spazi alla fine della stringa, selezionare Pad Right e inserire la lunghezza totale della stringa.
   • Per rimuovere gli spazi iniziali dall'inizio della stringa, selezionare Trim Prefix.
   • Per rimuovere gli spazi residui dalla fine della stringa, selezionare Trim Suffix.
   • Per rimuovere gli spazi sia all'inizio che alla fine della stringa, selezionare Taglia.

   Nota: Per trasformare l'output della stringa, selezionare la trasformazione aggiuntiva da applicare e fare clic su Aggiungereaggiungere.

3. Selezionare Accettare.

Dividere una stringa

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

1. Nella catena, selezionare il comando con l'input da trasformare e, in Proprietà del comando, fare clic sulla variabile o sull'output da trasformare.
2. Selezionare Split e fare clic su Aggiungereaggiungere.
3. Per Delimitatore, inserire il valore del testo in cui dividere la stringa.

   Nota: Per trasformare l'output della stringa, selezionare la trasformazione aggiuntiva da applicare e fare clic su Aggiungereaggiungere.

4. Selezionare Accettare.

Sostituire un valore in una stringa

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

1. Nella catena, selezionare il comando con l'input da trasformare e, in Proprietà del comando, fare clic sulla variabile o sull'output da trasformare.
2. Selezionare Sostituisci e fare clic su Aggiungereaggiungere.
3. In Trova, inserire i criteri del valore da sostituire nella stringa come testo esatto da abbinare o come espressione regolare.
4. In Sostituzione, inserire il valore per sostituire il testo che corrisponde ai criteri Trova.
5. In Tipo di corrispondenza, selezionare se cercare i criteri Trova con una corrispondenza esatta o un'espressione regolare (RegEx).

   Nota: Per trasformare l'output della stringa, selezionare la trasformazione aggiuntiva da applicare e fare clic su Aggiungereaggiungere.

6. Fare clic su Accettare.

Aggiungere, sottrarre, moltiplicare, dividere o arrotondare i numeri

Per eseguire un'operazione matematica su un valore numerico, applicare una trasformazione Aggiungi, Sottrai, Moltiplica, Dividi, o Arrotonda.

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

• Per una trasformazione Aggiungi o Sottrai, inserire di quanto aumentare o diminuire il numero.
• Per una trasformazione Moltiplicare o Dividere, inserire la quantità per cui moltiplicare o dividere il numero.
• Per una trasformazione Round, inserire il numero di spazi decimali a cui arrotondare il numero.

Analizzare una data o un timestamp come stringa

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

1. Nella catena, selezionare il comando con l'input da trasformare e, in Proprietà del comando, fare clic sulla variabile o sull'output da trasformare.
2. Selezionare Parse Date/Time e fare clic su Aggiungereaggiungere.
3. Selezionare se utilizzare il formato standard dell'International Organization for Standardization (ISO) o un formato personalizzato per la data o il timestamp.
4. Inserite come formattare i valori di data o ora usando i formati strftime e separatori come ., ,, :, o /. Ad esempio, %m-%d-%Y per 01-30-2020, oppure %H:%M per 21:08.
5. Per modificare il fuso orario della data o del timestamp, selezionare i fusi orari dei valori di ingresso e di uscita.

   Nota: Per trasformare l'output della stringa, selezionare la trasformazione aggiuntiva da applicare e fare clic su Aggiungereaggiungere.

6. Fare clic su Accettare.

Aggiungere o sottrarre una data o un timestamp

Per aggiungere o sottrarre un valore di intervallo a una variabile o a un output di data e ora, applicare la trasformazione Add/Subtract Date and Time:

1. Nella catena, selezionare il comando con l'input da trasformare e, in Proprietà del comando, fare clic sulla variabile o sull'output da trasformare.
2. Selezionare Aggiungi/Sottrai data e ora e fare clic su Aggiungiaggiungi.
3. Selezionare se utilizzare il formato standard dell'International Organization for Standardization (ISO) o un formato personalizzato.
4. Per Operation, selezionare se aggiungere o sottrarre il timestamp.
5. Immettere l'incremento da aggiungere o sottrarre al timestamp, ad esempio 1 giorno.

   Nota: Per modificare il formato del timestamp, selezionare Parse Date/Time e fare clic su Aggiungereaggiungere per applicare una trasformazione aggiuntiva.

6. Fare clic su Accettare.

Ordinare gli elementi di un elenco

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

1. Nella catena, selezionare il comando con l'input da trasformare e, in Proprietà del comando, fare clic sulla variabile o sull'output da trasformare.
2. Selezionare Sort List e fare clic su Addadd.
3. Selezionare se ordinare l'elenco in ordine crescente o decrescente.

   Nota: Per scegliere un elemento di stringa dall'elenco, selezionare Scegli dall'elenco e fare clic su Aggiungereaggiungere per applicare una trasformazione aggiuntiva.

4. Fare clic su Accettare.

Scegliere elementi da un elenco

Per estrarre un singolo elemento da una variabile di elenco o di output, applicare la trasformazione Pick from List:

1. Nella catena, selezionare il comando con l'input da trasformare e, in Proprietà del comando, fare clic sulla variabile o sull'output da trasformare.
2. Selezionare Scegliere dall'elenco e fare clic su Aggiungereaggiungere.
3. Per Valore, inserire il numero di indice dell'elemento da prelevare; 0 per il primo elemento, -1 per l'ultimo.

   Nota: Per trasformare l'elemento stringa, selezionare la trasformazione aggiuntiva da applicare e fare clic su Aggiungereaggiungere.

4. Fare clic su Accettare.

Ottenere i valori da JSON

Per convertire un singolo elemento di una variabile o di un output JSON in una stringa, un elenco o un JSON, applicare 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, fare clic su Monitorflight_takeoff e visualizzare l'output JSON del comando.

1. Nella catena, selezionare il comando con l'input da trasformare e, in Proprietà del comando, fare clic sulla variabile o sull'output da trasformare.
2. Selezionare Get Value from JSON e fare clic su Aggiungereaggiungere.
   
3. Selezionare se produrre l'elemento come stringa di testo titolo, elenco lista, o JSON codice.
4. Per Value, inserire:
   • Se il JSON include più oggetti, l'indice dell'oggetto da cui estrarre, a partire da 0. Ad esempio, per il secondo oggetto , inserire 1.

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

   • Il nome dell'elemento da scegliere, come id.

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

5. Fare clic su Accettare.