Per impostare i valori degli input che appaiono ripetutamente in più catene o comandi all'interno di una singola catena, puoi utilizzare le variabili . Invece di inserire lo stesso valore in più catene o comandi, puoi definirlo come una variabile e gestirne il valore in un'unica posizione.
- Le variabili dello spazio di lavoro definiscono valori che appaiono in più catene.
- Le variabili di catena definiscono valori che appaiono in più comandi di una catena e che possono cambiare frequentemente.
- Le variabili dinamiche definiscono i valori da impostare quando una catena viene eseguita o durante l'esecuzione di una catena, ad esempio in base all'output di un comando precedente.
Formazione aggiuntiva disponibile
Puoi imparare la potenza delle catene con il nostro corso autogestito nel Workiva Learning Hub. Questo corso completo ti guida attraverso il processo di creazione di una catena dall'inizio alla fine, fornendoti un'esperienza pratica e una profonda comprensione della piattaforma Builder catena.
Visita il Workiva Learning Hub
Gestisci le variabili del tuo spazio di lavoro
Dal tuo spazio di lavoro, puoi definire le variabili utilizzate da più catene:
- In Chain Builder, seleziona Settings in alto a sinistra.
- A destra di Variabili, clicca su Aggiungi.
- Per facilitare l'identificazione della variabile, inserisci il suo nome e, se necessario, il suo valore predefinito e la sua descrizione. Questi valori predefiniti possono essere personalizzati in seguito per le singole catene.
- Per una maggiore sicurezza, seleziona Crittografa - in questo modo si nasconderanno i valori sensibili come le password.
- Clicca su Salva.
Dopo aver aggiunto una variabile all'area di lavoro, puoi modificarne il nome, il valore o la crittografia come necessario. Per rimuovere una variabile dall'area di lavoro, clicca su Cancella.
Gestire le variabili di una catena
Per i valori che appaiono in più comandi all'interno di una catena e che cambiano frequentemente, aggiungili come variabili per la catena. Non c'è un limite rigido al numero di variabili in una catena, ma è stato riscontrato un degrado della reattività quando le catene si avvicinano a 1000 variabili.
- Nella catena, clicca su Impostazioni della catena.
- In Variabili, clicca su Aggiungi.
- Inserisci un nome e una descrizione unici per identificare la variabile e il suo scopo.
- Inserisci il valore predefinito della variabile.
- Per consentire solo agli amministratori di visualizzare il valore della variabile, ad esempio per le password, seleziona Encrypt.
- Clicca su Salva.
Per aggiornare una variabile, clicca su Modifica per la catena e regola il valore in Variabili.
Per rimuovere una variabile non più necessaria, clicca su Delete.
Gestire le variabili dinamiche di una catena
Per impostare i valori durante l'esecuzione della catena o per basarli sull'output di un altro comando, aggiungili come variabili dinamiche per la catena.
Nota: Per facilitare le esecuzioni consecutive, le variabili dinamiche mantengono i valori impostati durante l'esecuzione precedente della catena.
- Nella catena, clicca su Impostazioni della catena.
- In Variabili dinamiche, clicca su Aggiungi.
- Inserisci un nome univoco per identificare la variabile e il suo scopo.
Nota: Il campo Valore iniziale non è applicabile e deve essere lasciato vuoto.
- Clicca su Salva.
Nota: Per impostare i valori delle variabili dinamiche all'inizio dell'esecuzione di una catena, avviala con a Runtime Inputs trigger event. Per mettere in pausa una catena per definire il valore di una variabile dinamica prima di procedere al passo successivo, aggiungi a Set Dynamic Chain Variables event.
Per rimuovere una variabile che non ti serve più, clicca su Delete.
Utilizzare le variabili come input di comando
Per utilizzare le variabili come input testuali di un comando:
- Dalla catena, seleziona il comando per utilizzare le variabili.
- Nell'input basato sul testo per utilizzare una variabile, clicca su Variabile e seleziona la variabile.
Nota: Per concatenare più variabili all'interno di un input, seleziona le variabili da utilizzare e poi inserisci il testo che deve apparire prima o dopo ciascuna di esse.
- Clicca su Salva.
Nota: Per modificare o formattare una variabile da utilizzare come input di comando, applica una trasformazione della variabile .
Variabili di runtime
Per includere i dati relativi all'esecuzione di una catena, puoi utilizzare diverse variabili di runtime.
| Variabile | Descrizione |
|---|---|
| Chain.Environment | L'ambiente della catena in esecuzione |
| Chain.ExecutionDateTime | La data e l'ora di inizio della catena |
| Chain.ExecutorId | L'ID numerico della catena in esecuzione |
| Chain.Id | L'ID numerico di una catena nello stato non in esecuzione |
| Chain.Name | Il nome della catena in esecuzione |
| Chain.PreviousExecutionDateTime | La data e l'ora dell'ultima esecuzione della catena |
| URL della catena | L'URL univoco della catena in esecuzione |
| Chain.Workspace | Lo spazio di lavoro della catena in esecuzione |
| Command.ExecutorId | L'ID numerico del comando in esecuzione |
| Command.Id | L'ID numerico di un comando nello stato non in esecuzione |
| Command.Name | Il nome del comando in esecuzione |
| Command.URL | L'URL univoco del comando in esecuzione |
| Runner.InstallationDirectory | La directory di installazione del GroundRunner della catena; null se si utilizza un CloudRunner |
| System.Date | La data corrente del sistema |
| System.DateTime | La data e l'ora corrente del sistema |
| User.Email | L'indirizzo e-mail del collaboratore che ha gestito la catena |
| User.Id | L'ID del collaboratore che ha gestito la catena |
| User.Name | Il nome del collaboratore che ha gestito la catena |