Centro assistenza di Workiva

I comandi sono le operazioni eseguite all'interno della catena, sulla base di una connessione con una fonte di dati. Per le catene più complesse, questo può includere comandi attivati da una serie di condizioni.

Nota: Prima di aggiungere una catena, assicurarsi che l'organizzazione abbia impostato le connessioni necessarie per abilitare i comandi con le proprie origini dati.

Per eseguire comandi specifici in modo seriale- uno dopo l'altro, aspettando che il comando precedente sia terminato - o simultaneamente in parallelo, o per far fallire una catena se uno dei comandi fallisce, raggrupparli insieme.

Aggiungere un comando a una catena

1. Nella catena, selezionare il comando da eseguire:
   • Per aggiungere un nuovo comando alla catena, in Available Connectors (Connettori disponibili), fare clic sul relativo collegamento, quindi spostare il comando nella posizione in cui deve essere inserito nella catena.
   • Per duplicare un comando esistente, selezionare il suo nodo, fare clic su Copia  file_copia , e spostare il nuovo nodo nella posizione in cui deve trovarsi nella catena.

   Suggerimento: Per aggiungere un comando come primo nodo della catena, spostarlo in Avviare.

2. Per collegare il comando ai nodi precedenti e successivi della catena, fare clic e trascinare le linee tra le porte dei nodi.

   Nota: Per modificare la posizione di un nodo nella catena, scollegarlo dagli altri nodi e spostarlo nella posizione desiderata. Per spostare più nodi contemporaneamente, tenere premuto MAIUSC mentre li si seleziona.

3. Selezionare il nuovo nodo e fare clic su Edit  create.
4. Immettere i parametri del comando:
   • In Informazioni di base, inserire un nome e una descrizione univoci per identificare il comando e il suo scopo.
   • Attivare l'icona dell'occhio se si desidera mascherare i dati sensibili in uscita.
   • Per eseguire il comando più volte, per ogni elemento dell'elenco, attivare Iteratore ripetere, e inserire i valori di iterazione.
   • In Proprietà del comando, inserire gli ingressi del comando, in base al connettore.
5. Clicca su Salva.

Eseguire solo un singolo comando o gruppo

Per facilitare i test e le iterazioni rapide durante la creazione delle catene, è possibile eseguire un singolo comando o un gruppo di comandi all'interno di una catena.

1. In Chain Builder, dalla scheda Chains , selezionare Execute  flight_takeoff dal menu della catena.
2. Per il comando o il gruppo da eseguire, fare clic su Execute this command  play_circle_outline.
3. Fare clic su Eseguire la catena.

Saltare un comando

Per sviluppare una logica di ramificazione o come parte dello sviluppo di una catena, potrebbe essere necessario saltare un comando per forzare un risultato specifico. È anche possibile impostare una logica condizionale per restituire automaticamente un risultato specifico in base alle regole impostate.

1. Nella catena, selezionare il nodo del comando, fare clic su Edit  create , e selezionare Skip skip_next.
2. Scegliere se restituire automaticamente un risultato di info  check_circle, warning  warning, o error  error per il comando quando viene saltato.
3. Per saltare il comando solo se vengono soddisfatti criteri specifici, specificare quando. Costruite la logica condizionale come un gruppo a cui aggiungere regole e altri gruppi di regole, ciascuno unito a un booleano AND o OR.
   • Se tutte le condizioni devono essere vere per essere saltate, seleziona AND.
   • Se per saltare una sola condizione deve essere vera, selezionare OR.

   Puoi aggiungere regole basate su vari tipi di dati:

   Tipo di dati	Descrizione
   Stringa	Due o più caratteri
   Numero intero	Qualsiasi valore numerico intero e non decimale
   Data	Qualsiasi stringa di data o variabile Data
   Float	Qualsiasi valore numerico
   JSON	Notazione degli oggetti JavaScript; usa Trasformazione variabile per analizzare gli oggetti

   Per verificare se i dati soddisfano i criteri per saltare il comando, abbinali a un operatore e a un valore:

   • È vuoto o Non è vuoto
   • Contiene
   • Corrisponde a RegExp, per un'espressione regolare
   • Inizia con o Termina con
   • = o ! =
   • < o >
   • <= o >=
4. Clicca su Salva.

Gestire la gestione degli errori di un comando

Per rilevare o ignorare gli errori di un comando:

1. Nella catena, clicca sul nodo del comando, clicca su Modifica create, e seleziona Gestione degli errori warning.
2. In Azioni di errore  ripetere, selezionare cosa fare se il comando non riesce.
   
   • Per seguire la logica di ramificazione della catena, selezionare Continua con la catena.
   • Per interrompere temporaneamente la catena, ad esempio per rimediare al problema, selezionare Pausa catena. Per riavviare la catena dopo la risoluzione del problema, selezionare il comando nella catena e fare clic su Riprendi.
   • Per interrompere completamente la catena, selezionare Esci dalla catena.
3. Per interrompere il comando se impiega più tempo del dovuto, in Condizioni di timeout  allarme, inserire la durata massima in secondi.
   
4. Per riprovare un comando se la sua fonte di dati è intermittente o non disponibile, inserire il numero di tentativi da eseguire e il numero di secondi da attendere tra un tentativo e l'altro.
5. In Condizioni di errore  priority_high, selezionare gli errori da ignorare, ad esempio quando si crea una cartella già esistente.
6. Per impostare lo stato del comando in base al suo output, fare clic su Aggiungere sotto Interpretazione dell'output, e definire la regola o il gruppo di regole per interpretare il suo stato.Ad esempio, con la variabile Status dell'output Command Details , è possibile impostare una regola per ottenere un avviso quando il comando ha successo.
   
7. In Interpretazione del registro, selezionare se rifiutare il comando in base al fatto che si producano uscite specifiche.
   • Per non fallire il comando in base a uscite specifiche, selezionare Non interpretare.
   • Per rifiutare il comando quando vengono trovate uscite specifiche, selezionare Fail if output(s) found e immettere le uscite da analizzare.
   • Per non eseguire il comando quando non vengono trovate uscite specifiche, selezionare Fail if output(s) not found e immettere l'uscita da cercare.
   • Le righe di testo multiple devono essere separate da
8. Clicca su Salva.

Visualizzare l'output di un comando

Da Monitor flight_takeoff, è possibile visualizzare l'anteprima dell'output di un comando eseguito tramite CloudRunner. 

1. In Chain Builder, da Monitor, aprire la corsa con l'output da visualizzare in anteprima e selezionare il comando.
2. Nella scheda Output , fare clic su Anteprima dell'output visibilità per visualizzare l'output.
   

Nota: È possibile visualizzare in anteprima solo gli output dei comandi eseguiti tramite CloudRunner, non GroundRunner.

Rimuovere un comando da una catena

Per rimuovere un comando da una catena, fare clic sul relativo nodo, su Cancellare  Cancellare, quindi su Cancellare.

Nota: Per garantire la logica della catena, non è possibile eliminare un comando se il suo genitore ha più fratelli o rami allo stesso livello.