Creare e gestire le catene

Per automatizzare i flussi di lavoro nella piattaforma Workiva e in altre fonti di dati, i proprietari degli spazi di lavoro possono creare e gestire sequenze lineari di attività come catene. Ad esempio, puoi creare una catena per aggiornare automaticamente le informazioni finanziarie da una fonte di dati in una tabella e poi inviare i dati a un'altra fonte di dati per generare un report.

Formazione aggiuntiva disponibile

Sblocca 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

Requisiti

I seguenti ruoli utente di Wdata possono creare e gestire catene:

Proprietario dello spazio di lavoro con il ruolo Editor, Professional, o Standard
Proprietario della catena con il ruolo Editor, Professional, o Standard
Costruttore di catene con permessi appropriati

Accesso alle catene

Clicca su Chains => Chain Builder in Wdata per visualizzare e gestire le tue catene. Da Admin => Security, puoi tracciare gli eventi di controllo relativi alla creazione e alla gestione delle catene.

Creare una catena

Per definire la sequenza di comandi ed eventi che si verificheranno con una catena, puoi:

Creare la catena da zero
Crea la catena da un modello
Iniziare con una copia di una catena simile

Per facilitare il riutilizzo, ti consigliamo di creare anche variabili da utilizzare all'interno delle tue catene o in fase di esecuzione.

Da Chain Builder, puoi trascinare e collegare i passi o i nodi - all'interno di una catena.

Passo 1: Aggiungere la catena e impostarne i dettagli

Da Catene, clicca su Crea => Crea catena.

Nota: Puoi anche creare una catena direttamente dalla scheda Catene passando il mouse sull'icona Build device_hub in alto a destra.
In Setup, inserisci un nome e una descrizione unici per identificare la catena e il suo scopo.
Per consentire alla catena di essere eseguita più volte contemporaneamente, ad esempio con input di runtime diversi per ogni istanza, seleziona Consenti esecuzioni simultanee.
Per impedire l'esecuzione della catena, ad esempio per posticiparne l'utilizzo, seleziona Disabilita l'esecuzione.
Definisci i valori condivisi o dinamici utilizzati nella catena:
- Sotto Variabili codice, definiscono valori che appaiono in più comandi e che cambiano frequentemente.
- In Variabili dinamiche codice, definisci i valori da impostare all'avvio della catena o durante la sua esecuzione, ad esempio in base agli output dei comandi precedenti.
Nota: Per chiedere ai collaboratori di inserire i valori delle variabili dinamiche, includi un evento Runtime Inputs o Set Dynamic Chain Variables .
Per eseguire automaticamente la catena a intervalli regolari o in un intervallo di date specifico, in Schedules alarm, specifica quando e quanto spesso deve iniziare.
Clicca su Salva.

Passo 2: Definire i nodi della catena

Quando costruisci una catena, includi e colleghi i suoi molteplici nodi:

Comandi, ovvero le attività eseguite dalla catena per interagire con la piattaforma Workiva o con un'altra fonte di dati.
Eventi della catena che si verificano all'interno della catena, ad esempio per attivare un flusso di lavoro di approvazione o il caricamento manuale di file.
Eventi di attivazione, come input di runtime per impostare variabili, come ad esempio account specifici, regioni o periodi di tempo, quando esegui la catena o per avviare automaticamente la catena in base alle modifiche delle fonti collegate.

Aggiungere nodi

Quando aggiungi un nodo, spostalo nel punto in cui si trova nella catena e collegalo ai passi successivi e precedenti.

Per aggiungere il primo nodo della catena, spostalo in Inizia.
Per aggiungere un nodo come inizio di un nuovo ramo di un albero logico, collega il passo precedente della catena al primo nodo dei rami multipli.
Per eseguire i comandi in parallelo tra loro o insieme come parte di un processo seriale, spostali uno sopra l'altro in e crea un gruppo di comandi come passo.

Nota: Per impostazione predefinita, un nodo viene eseguito quando il nodo precedente collegato ha successo. Per abilitare la logica condizionale, ad esempio per eseguire un nodo solo quando il nodo precedente fallisce, fai doppio clic sul collegamento e seleziona la sua condizione: successo check_circle, fallimento errore, avvertimento warning, o qualsiasi check_circle.

Dopo aver definito i nodi della catena, clicca su Pubblica per abilitarla all'esecuzione.

Nota: Mentre puoi pubblicare una catena con nodi non collegati, solo quelli collegati tra loro - a partire dal nodo Start - vengono eseguiti quando esegui la catena.

Per facilitare la creazione di una catena, puoi iniziare con un modello che fornisce la struttura dei suoi comandi, eventi e variabili.

Passo 1. Crea la catena

In Chain Builder, dalla scheda Templatesdynamic_feed o Chains device_hub, crea la catena dal modello:
- Da Templates, clicca sul nome del modello e poi su New Chain in alto a destra.
- Da Chains, clicca sull'icona Build device_hub e poi Create Chain from Template. Puoi quindi selezionare il modello da utilizzare.
Inserisci un nome univoco per identificare la catena.
Seleziona l'area di lavoro e l'ambiente in cui utilizzare la catena e clicca su Avanti.

Passo 2. Mappare le variabili e le connessioni del modello

Per ogni variabile del modello, seleziona il valore da sostituire nella catena:
- Per una variabile impostata all'interno della catena , seleziona Variable Type of Chain e inserisci un nome per la nuova variabile della catena.
- Per una variabile impostata all'interno dell'area di lavoro, seleziona Variable Type di Workspace e seleziona la variabile dell'area di lavoro da utilizzare.
- Per un file caricato come risorsa all'interno dell'area di lavoro, seleziona Variable Type of Workspace Resource e seleziona la risorsa da utilizzare.
- Per un valore dinamico impostato durante l'esecuzione della catena, seleziona Variable Type of Chain Dynamic e inserisci un nome per la nuova variabile dinamica della catena.
- Per un valore generato durante l'esecuzione della catena, seleziona Tipo di variabile di Runtime e seleziona la variabile di runtime da utilizzare.
Nota: Se selezioni Dynamic o Resource quando aggiungi la variabile al modello, non puoi selezionare un altro tipo di variabile.
Dopo aver mappato le variabili del modello nelle loro nuove variabili o risorse, clicca su Next.
Per ogni connessione utilizzata nel modello, seleziona il connettore e il runner per eseguire i suoi comandi e clicca su Submit.

Passo 3. Finalizzare la catena

Clicca su Visualizza la tua nuova catena.
Personalizza la nuova catena come necessario:
- Aggiorna le variabili della catena utilizzate dalle variabili del modello.
- Aggiungi altri comandi o eventi per avviare o completare la catena.
Clicca su Pubblica.

Per creare una catena simile a un'altra catena nell'area di lavoro, puoi usare una copia come punto di partenza.

Suggerimento: Se utilizzi spesso una catena come punto di partenza per altre catene, crea un modello basato sulla sua sequenza di nodi.

In Chain Builder, dalla scheda Chains device_hub, seleziona Copy file_copy dal menu della catena esistente.
Per la nuova copia, clicca su Modifica crea e aggiorna i suoi nodi o le sue proprietà come necessario.

Promuovere una catena in un ambiente diverso

Nell'ambito del ciclo di vita dello sviluppo, puoi creare le catene in un ambiente separato da quello in cui vengono eseguite dai collaboratori. Ad esempio, puoi creare catene in un ambiente DEV finché non sono pronte per essere utilizzate in un ambiente PROD. Per spostare una catena da un ambiente all'altro, puoi promuoverla.

In Chain Builder, dalla scheda Chains device_hub, seleziona Promotetrending_up dal menu della catena.
In Name, modifica il nome della catena per il suo nuovo ambiente come necessario.
In Promuovi a, seleziona il nuovo ambiente della catena.
Seleziona se abilitare le pianificazioni sulla catena promossa e clicca su Avanti.
Per ogni connessione della catena, scegli la connessione da utilizzare nel nuovo ambiente e clicca su Avanti.
Esamina la mappatura delle connessioni e clicca su Promuovi.

Modifica una catena

Per aggiornare i passi o le proprietà di una catena:

In Chain Builder, dalla scheda Chains device_hub, clicca su Editcreate per la catena e aggiorna i suoi comandi e eventi come necessario.
Per aggiornare le proprietà della catena, clicca su Impostazioni della catena e regola le pianificazioni, le variabili e le notifiche come necessario.
Per aggiornare in blocco le connessioni di comando della catena, clicca sul menu a tre punti e regola i comandi .

Suggerimento: Puoi organizzare facilmente le tue catene selezionando più nodi contemporaneamente. Basta premere `Shift` e trascinare il cursore del mouse sulla tela. Per saperne di più.

Riportare una catena a una versione precedente

Per riportare una catena a una versione precedentemente pubblicata, ad esempio per annullare le modifiche o creare una nuova catena da una versione precedente di un'altra:

In Chain Builder, dalla scheda Chains device_hub, seleziona Versionsassignment_return dal menu della catena.
In Versioni passate, seleziona la versione da ripristinare e clicca su Revert Chainhistory.
Seleziona il connettore e il runner per ogni connessione e imposta le variabili.
Clicca su Invia, Visualizza la catena invertita, e Pubblica.

Tag di catena

I Tag di Catena permettono di raggruppare le Catene correlate tra loro e di dare un'occhiata al contenuto della Catena. Una volta creato un tag, questo può essere utilizzato come filtro per le catene nella vista Elenco catene e nell'Utilità di pianificazione.

Aggiungere un tag alla catena

Seleziona la catena per espandere la vista
Clicca sull'icona più (+) per inserire il nome di un nuovo tag o selezionare un tag esistente
Puoi impostare il colore dell'etichetta cliccando sull'etichetta e scegliendo un colore.

Rimozione di un'etichetta a catena

Seleziona la catena per espandere la vista
Passa il mouse sopra il tag e clicca sulla (x) grigia

Nota: Aggiorna la vista del browser dopo aver cancellato un tag. I tag scompariranno se tutte le catene di un tenant sono state dissociate da quel tag.

Assistenza

Community

Centro assistenza di Workiva