Centro assistenza di Workiva

I comandi sono le attività eseguite all'interno della catena, in base a 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, assicurati che la tua organizzazione abbia impostato le connessioni necessarie per abilitare i comandi con le sue fonti di dati.

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

Aggiungi un comando a una catena

1. Nella catena, seleziona il comando da eseguire:
   • Per aggiungere un nuovo comando alla catena, alla voce Connettori disponibili, clicca sul suo collegamento e sposta il comando nella posizione in cui deve essere inserito nella catena.
   • Per duplicare un comando esistente, seleziona il suo nodo, clicca su Copia file_copia, e sposta il nuovo nodo nella posizione in cui deve essere presente nella catena.

   Suggerimento: Per aggiungere un comando come primo nodo della catena, spostalo su Avvia.

2. Per collegare il comando ai nodi precedenti e successivi della catena, clicca e trascina le linee tra le porte dei nodi.

   Nota: Per cambiare la posizione di un nodo nella catena, scollegalo dagli altri nodi e poi spostalo nel punto in cui dovrebbe trovarsi. Per spostare più nodi contemporaneamente, tieni premuto SHIFT mentre li selezioni.

3. Seleziona il nuovo nodo e clicca su Modifica crea.
4. Inserisci i parametri del comando:
   • Alla voce Informazioni di base, inserisci un nome e una descrizione unici per identificare il comando e il suo scopo.
   • Attiva l'icona dell'occhio se desideri mascherare i dati sensibili in uscita.
   • Per eseguire il comando più volte, per ogni elemento dell'elenco, attiva Iteratorrepeat, e inserisci i valori di iterazione.
   • In Proprietà del comando, inserisci gli input 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, puoi eseguire un singolo comando o gruppo di comandi all'interno di una catena.

1. In Chain Builder, dalla scheda Chains seleziona Execute flight_takeoff dal menu della catena.
2. Per il comando o il gruppo da eseguire, clicca su Esegui questo comando play_circle_outline.
3. Clicca su Esegui 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. Puoi anche impostare una logica condizionale per restituire automaticamente un risultato specifico in base alle regole impostate.

1. Nella catena, seleziona il nodo del comando, clicca su Edit create, e seleziona Skipskip_next.
2. Scegli 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, specifica quando. Crea 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 solo una condizione deve essere vera per saltare, seleziona 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.

Gestisci 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 ripeti, seleziona cosa fare se il comando fallisce.
   
   • Per seguire la logica di ramificazione della catena, seleziona Continua con la catena.
   • Per interrompere temporaneamente la catena, ad esempio per risolvere il problema, seleziona Pause chain. Per riavviare la catena dopo la risoluzione del problema, seleziona il comando nella catena e clicca su Riprendi.
   • Per interrompere completamente la catena, seleziona Esci dalla catena.
3. Per interrompere il comando se impiega più tempo del dovuto, in Condizioni di timeout allarme, inserisci la sua durata massima in secondi.
   
4. Per riprovare un comando se la sua fonte di dati è intermittente o non disponibile, inserisci il numero di tentativi da effettuare e il numero di secondi da attendere tra un tentativo e l'altro.
5. In Condizioni di errore priority_high, seleziona 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, clicca su Aggiungi sotto Interpretazione dell'output e definisci la regola o il gruppo di regole per interpretarne lo stato.  Ad esempio, con la variabile Status dell'output Command Details, puoi impostare una regola per ottenere un avviso quando il comando ha successo.
   
7. In Interpretazione del registro, seleziona se rifiutare il comando in base al fatto che produca o meno degli output specifici.
   • Per non fallire il comando in base a uscite specifiche, seleziona Non interpretare.
   • Per non eseguire il comando quando vengono trovati degli output specifici, seleziona Fail if output(s) found e inserisci gli output da scansionare.
   • Per non eseguire il comando quando gli output specifici non vengono trovati, seleziona Fail if output(s) not found e inserisci l'output per il quale eseguire la scansione.
   • Più righe di testo devono essere separate con \n
8. Clicca su Salva.

Visualizza l'output di un comando

Da Monitorflight_takeoff, puoi visualizzare l'anteprima dell'output di un comando eseguito tramite il CloudRunner. 

1. In Chain Builder, da Monitor, apri la sessione con l'output da visualizzare in anteprima e seleziona il comando.
2. Nella scheda Outputs, clicca su Anteprima dell'outputvisibilità per visualizzare l'output.
   

Nota: Puoi visualizzare l'anteprima degli output dei comandi eseguiti attraverso il CloudRunner, non un GroundRunner.

Rimuovere un comando da una catena

Per rimuovere un comando da una catena, clicca sul suo nodo, clicca su Elimina elimina, quindi clicca su Elimina.

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