Importante: Facendo clic su Annulla su una qualsiasi di queste schede si chiude la finestra di configurazione dei comandi. Tutte le modifiche apportate dall'ultima volta che hai cliccato su Salva saranno eliminate e non potranno essere recuperate.
Scheda Comando di modifica
La scheda Modifica il comando ti permette di impostare quali campi devono essere considerati o esclusi quando viene eseguito questo comando.
Per modificare questo comando:
- Seleziona la scheda Modifica il comando.
- (Facoltativo) In Name, modifica il nome predefinito fornito.
- (Facoltativo) In Descrizione, inserisci una descrizione utile di ciò che il comando è configurato a fare.
-
In Proprietà del comando, seleziona la Workday Connection appropriata per questo comando e il tipo di connessione (CloudRunner o GroundRunner).
Nota: CloudRunner è la scelta predefinita, ma questa connessione funziona anche con un GroundRunner. Per informazioni sull'installazione e l'utilizzo di un GroundRunner, consulta la pagina del supporto Workiva Installare e gestire i GroundRunner.
-
Seleziona il file di input da utilizzare.
Questo è un file .csv contenente i dati di partenza. Un modello di questo file è disponibile nella documentazione di Workiva.Nota: Se stai utilizzando un modello EIB (vedi sotto), le intestazioni del CSV devono corrispondere ai campi definiti nel file del modello.
- In Configurazione del budget, inserisci l'ID della struttura del budget associato alla struttura del piano e l'Custom_Budget_ID associato al nome del piano finanziario.
-
Seleziona la modalità di importazione da utilizzare.
Modalità di importazione Comportamento Solo aggiunte incrementali Aggiunge nuove righe e aggiorna quelle esistenti. Non cancella nulla. Sostituisci tutto Cancella l'intero piano di bilancio esistente e lo sostituisce rigorosamente con i dati del tuo file. Aggiunta incrementale con cancellazione Sincronizza il sistema in modo che corrisponda al file caricato. Aggiunge nuove righe, aggiorna quelle esistenti ed elimina quelle mancanti nel sistema rispetto al file caricato. Sostituisci tutto per periodo Cancella e sostituisce i dati solo per i periodi di tempo presenti nel file caricato. Conserva i dati per altri mesi/periodi. - (Facoltativo) Inserisci un Memo che descriva lo scopo del comando.
-
Seleziona le azioni da attivare al completamento di questo nodo.
Comando Descrizione Completamento automatico Quando è contrassegnato (spuntato), il processo aziendale viene elaborato automaticamente. Ciò significa che tutte le approvazioni saranno automaticamente approvate nel sistema, tutte le revisioni e i to-do saranno automaticamente bypassati e tutte le notifiche saranno automaticamente soppresse. Invia Quando è contrassegnato (spuntato), la catena invia automaticamente l'azione.
L'ultimo campo e la casella di controllo servono solo per utilizzare i modelli EIB. Se non stai usando un file modello EIB, puoi ignorare entrambi i punti.
Nota:Il modello EIB deve essere un file XML che definisce i campi necessari per completare un'azione di Importazione del budget. Se specificato, avrà la precedenza sui dati della "Configurazione del budget".
- Se stai utilizzando un file modello BEI per importare i dati di bilancio, inserisci il nome del file nel campo File modello BEI.
- (Facoltativo) Seleziona la casella di controllo Ignore warnings per ignorare tutti gli avvisi relativi ai campi opzionali mancanti.
Il file del modello conterrà dei campi opzionali, quindi il comando darà un errore se i campi non sono presenti, a meno che non sia stata selezionata questa opzione.
Questa opzione è applicabile solo ai processi di importazione del bilancio che utilizzano un modello EIB.
Scheda Notifiche
La scheda Notifiche ti permette di impostare un'e-mail di notifica da inviare quando si verifica una condizione.
Per creare una notifica:
- Seleziona la scheda Notifiche.
- Clicca su Nuova notifica.
- Clicca su Email.
-
Completa i campi del pannello di notifica.
Campi del pannello di notifica
Nome del campo Valori e azioni supportati Condizione Le condizioni supportate sono:
- Successo: il comando è stato completato correttamente.
- Errore: il comando è fallito in qualche modo.
- Avvertenza: indica che è stato compromesso un risultato previsto, ma potrebbero esserci delle circostanze in sospeso su come si è verificato. Controlla i registri di output del comando per avere informazioni più specifiche sul motivo per cui è stato attivato.
- Pausa è uno stato del comando. Se il comando è "in pausa", la notifica verrà inviata. Non ha nulla a che fare con la pausa delle notifiche.
- Invia sempre: Invia sempre il messaggio.
Destinatari Indirizzi e-mail (deve essere un indirizzo e-mail completo) a cui inviare il messaggio. Cliccando su questo campo si apre un elenco a tendina di tutti gli indirizzi e-mail validi per l'area di lavoro. Non è possibile indicare altre email. Oggetto L'oggetto dell'e-mail. L'impostazione predefinita utilizza le variabili Chain.Environment, Chain.Name, e Command Name, seguite dalla condizione selezionata, ma puoi inserire un testo personalizzato se lo desideri. Allegato Questo ti permette di allegare un file all'e-mail. Seleziona il file tra quelli elencati nel riquadro Seleziona una variabile a sinistra della finestra di configurazione. Nome dell’allegato Questo è il nome (compresa l'estensione, ad esempio .txt o .csv) da assegnare al file. Corpo del messaggio Il testo da inserire nel messaggio e-mail. È supportata la formattazione HTML di base. - Clicca su Salva.
Per inviare altre notifiche via e-mail, clicca su Nuova notifica sotto la notifica corrente e ripeti questi passaggi.
Per maggiori informazioni sulle notifiche, consulta la pagina di supporto di Workiva Gestire le notifiche a catena e a comando.
Salta la scheda Condizioni
La scheda Condizioni di salto ti permette di specificare una condizione che farà saltare il comando e cosa succederà se il comando viene saltato.
Per stabilire una condizione di salto per questo comando:
- Seleziona la scheda Condizioni di salto.
- Clicca nel campo Salta le condizioni e seleziona la condizione di attivazione.
Le opzioni sono:- Successo (il comando è stato completato correttamente).
- Errore (il comando è fallito in qualche modo).
-
Avvertenza (indica che è stato compromesso un risultato previsto, ma potrebbero esserci delle circostanze in sospeso su come si è verificato. Controlla i registri di output del comando per avere informazioni più specifiche sul motivo per cui è stato attivato)
- Crea la regola che determina cosa succede quando il comando viene saltato.
- Seleziona E o O. Per impostazione predefinita, la prima istruzione inizia con E.
-
Clicca su +RULE e seleziona il tipo di dati da testare.
Le opzioni sono String (predefinito), Integer, Date, Float, e JSON. - Inserisci i criteri da utilizzare per il test.
-
Seleziona il valore del test. Le opzioni sono le seguenti:
Opzione Risultato È vuoto Il risultato è vuoto (un insieme vuoto). Non è vuoto Il risultato non è un insieme vuoto. Contiene Il risultato contiene un valore specifico. Selezionando questa opzione si apre un campo secondario in cui inserire la stringa da abbinare. Corrisponde a RegExp Il risultato corrisponde all'espressione regolare specifica. Selezionando questa opzione si apre un campo secondario in cui inserire l'espressione regolare. Inizia con Il risultato inizia con una stringa specifica. Selezionando questa opzione si apre un campo secondario in cui inserire la stringa. Termina con Il risultato termina con una stringa specifica. Selezionando questa opzione si apre un campo secondario in cui inserire la stringa. = (uguale) Il risultato corrisponde a un valore specifico. Selezionando questa opzione si apre un campo secondario in cui inserire il valore. != (non è uguale) Il risultato non corrisponde a un valore specifico. Selezionando questa opzione si apre un campo secondario in cui inserire il valore. < (meno di) Il risultato è inferiore a un valore specifico. Selezionando questa opzione si apre un campo secondario in cui inserire il valore. > (maggiore di) Il risultato è superiore a un valore specifico. Selezionando questa opzione si apre un campo secondario in cui inserire il valore. <= (minore o uguale a) Il risultato è inferiore o uguale a un valore specifico. Selezionando questa opzione si apre un campo secondario in cui inserire il valore. >= (maggiore o uguale a) Il risultato è maggiore o uguale a un valore specifico. Selezionando questa opzione si apre un campo secondario in cui inserire il valore da considerare.
- Se hai una sola condizione, clicca su Salva.
- Se hai più di una condizione, clicca nuovamente su +RULE per aggiungere una singola condizione oppure su +GROUP per fare in modo che le condizioni vengano valutate come un gruppo.
Note
- Le condizioni vengono valutate nell'ordine in cui sono elencate (dall'alto verso il basso). Le condizioni raggruppate vengono valutate come un'unità e poi il risultato viene valutato nell'ordine in cui il gruppo appare nell'elenco.
- Non esiste un modo per riordinare le condizioni; se vuoi cambiare l'ordine delle condizioni, dovrai ricreare l'elenco nell'ordine in cui vuoi che vengano valutate.
- Per maggiori informazioni sulle condizioni di salto, consulta la pagina della Workiva Community Condizioni di salto: Non vanno saltate, ma vale la pena considerarle! e alla pagina di supporto di Workiva Gestione dei comandi nelle catene.
Scheda Uscite dinamiche
La scheda Uscite dinamiche ti permette di specificare le regole per estrarre un valore o un elenco di valori dall'output di un comando, che può essere utilizzato successivamente nella catena. Puoi aggiungere più output dinamici a un comando utilizzando una delle due opzioni:
- Una corrispondenza esatta - con un testo specifico all'inizio o alla fine dei valori da estrarre.
- Un'espressione regolare - per abbinare i valori in base a un modello o a una sequenza specifica.
Per impostare le regole di output dinamico, procedi come segue.
- Seleziona la scheda Uscite dinamiche.
- Clicca su +ADD DYNAMIC OUTPUT. Viene visualizzato il pannello di configurazione dell'uscita dinamica.
- Inserisci un Nome per questo output.
- In Output originale, seleziona l'output da trasformare.
- Configura il modo in cui l'output deve essere derivato e memorizzato. I seguenti campi sono tutti opzionali.
- Il campo Match text può contenere il testo da abbinare o un'espressione regolare.
- Per ottenere una corrispondenza esatta con il testo fornito, seleziona "Exact" in Tipo di corrispondenza.
- Per utilizzare un'espressione regolare, seleziona "Espressione regolare (regex)" in Tipo di partita.
- In Risultato della corrispondenza, inserisci come deve essere visualizzato il testo risultante.
Ad esempio, se il risultato è costituito da cifre racchiuse tra parentesi, devi inserire $0 per visualizzare l'intero valore corrispondente, comprese le parentesi, oppure $1 per visualizzare solo le cifre corrispondenti senza le parentesi. - Per trovare una corrispondenza con il testo solo in determinate righe dell'output, inserisci il numero di riga o l'intervallo di numeri separati da virgole in Righe da controllare. Per includere un intervallo di righe, usa un trattino (-), quindi 1-10 restituisce il contenuto solo delle righe da 1 a 10. Per separare le righe o gli intervalli, usa una virgola (,), quindi 1-10, 13 restituisce il contenuto solo delle righe da 1 a 10 e della riga 13.
- In Tipo di output, seleziona se vuoi ottenere un singolo output o un elenco di output.
- Segna o deseleziona le caselle Case sensitive e Trim Matches per ottenere i risultati desiderati.
- Clicca su Salva.
- (Facoltativo) Clicca su Test per verificare se i risultati sono quelli attesi.
Se vuoi creare un'uscita dinamica aggiuntiva, clicca su +ADD DYNAMIC OUTPUT. Visualizza il pannello di configurazione dell'uscita dinamica per un'uscita dinamica aggiuntiva.
Per maggiori informazioni su come lavorare con gli operatori dinamici, consulta la pagina di supporto di Workiva Gestire le uscite dinamiche per un comando.
Scheda Azioni di errore
La scheda Azioni di errore ti permette di specificare cosa deve accadere se si verifica un errore nell'elaborazione del comando.
Per impostare le azioni da intraprendere se questo comando genera un errore:
- Seleziona la scheda Azioni di errore.
- In Azioni di errore, seleziona l'azione che vuoi che la catena intraprenda 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.
- Per interrompere il comando se sta funzionando più a lungo di quanto desiderato, in Condizioni di timeout, inserisci il tempo massimo di esecuzione dell'attività (in secondi).
- 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.
-
In Condizioni di errore, seleziona gli errori da ignorare.
Condizioni Descrizione Argomenti non validi Contrassegnando questa opzione, il comando ignora qualsiasi argomento non valido. Errore generale Selezionando questa opzione, la catena continuerà anche se il comando potrebbe essere fallito. - Per impostare lo stato del comando in base al suo output, clicca sul segno più cerchiato di verde a sinistra di Output interpretation.
- Clicca su +Regola e definisci la regola - o il gruppo di regole - per interpretare lo stato di uscita.
Se vuoi specificare altre condizioni, clicca sul segno più cerchiato di blu per aggiungere altri campi di definizione delle condizioni.
Le condizioni vengono valutate nell'ordine in cui sono elencate (dall'alto verso il basso). Le condizioni raggruppate vengono valutate come un'unità e poi il risultato viene valutato nell'ordine in cui il gruppo appare nell'elenco.
Nota: Non esiste un modo per riordinare le condizioni; se vuoi cambiare l'ordine delle condizioni, dovrai ricreare l'elenco nell'ordine in cui vuoi che vengano valutate.
- In Interpretazione dei log, seleziona se rifiutare il comando sulla base di output specifici.
- Per non fallire il comando in base a uscite specifiche, seleziona Non interpretare.
- Per non eseguire il comando quando vengono trovate delle uscite specifiche, seleziona Fail if output(s) found, e inserisci le uscite da scansionare.
- Per non eseguire il comando quando non vengono trovati output specifici, seleziona Fail if output(s) not found, e inserisci l'output da scansionare.
- Separa più righe di testo con \n.
- Clicca su Salva.
Scheda Iteratori
La scheda Iterators ti permette di impostare le regole per l'iterazione (ciclica o ripetuta) del comando Get Workers.
Nota: Questa scheda è disabilitata per impostazione predefinita.
Per impostare le regole di iterazione, procedi come segue.
- Seleziona la scheda Iteratori.
- Attiva gli iteratori selezionando l'interruttore nella parte superiore della scheda.
In questo modo, l'icona accanto all'intestazione della scheda (Iterators) passa dal grigio scuro al blu e visualizza il pannello di configurazione degli iteratori. Anche l'indicatore accanto al titolo della scheda diventa verde. -
Seleziona il tipo di modificatore da utilizzare.
Le opzioni sono List (predefinito) e Repeat until.- Selezionando List il comando viene ripetuto:
- Un elenco statico di valori, come regioni o entità. Anche questo può essere un numero, ad esempio "3".
- Un elenco dinamico o variabile di valori, come ad esempio un file caricato come risorsa dell'area di lavoro o l'output di un comando precedente nella catena.
- Selezionando Ripeti fino a il comando viene ripetuto fino a quando non viene soddisfatta la condizione specificata.
Nota: i comandi di sono limitati a un massimo di 1000 iterazioni.
- Selezionando List il comando viene ripetuto:
- Inserisci le regole per controllare le iterazioni.
Per maggiori informazioni sull'uso degli iteratori, incluso il modo in cui specificarli, consulta la pagina di supporto di Workiva Utilizzare gli iteratori con i comandi e i gruppi di comandi. - Clicca su Salva.