Centro assistenza di Workiva

Quando crei un modello, puoi utilizzare una catena pubblicata come base o creare una nuova sequenza di comandi ed eventi partendo da zero.

Questi modelli ti permetteranno di creare una sequenza pre-costruita di comandi ed eventi da utilizzare per altre catene. Ad esempio, con i modelli puoi:

• Fornire un vantaggio per facilitare la creazione della catena.
• Standardizza i flussi di lavoro comuni, ad esempio per estrarre i dati dal tuo sistema di record.

Nota: Puoi utilizzare un modello con più catene, spazi di lavoro e ambienti in Chain Builder.

Creare un modello da una catena esistente

Creare un modello da una catena esistente offre una serie di vantaggi:

• Puoi usare la prima catena come punto di partenza per creare altre catene.
• Puoi condividere la catena con altri utenti utilizzando Chain Builder- inclusi quelli di altre organizzazioni, come ad esempio la Workiva Community. 

Per creare un modello da una catena esistente:

1. Da Catene, clicca su Builder catena.
2. Seleziona la scheda Chains device_hub e seleziona Edit create per la catena.
3. Dal menu a tre puntini della catena in alto a destra, seleziona Crea il modello.
   
4. Inserisci un nome e una descrizione unici per identificare il modello.
   
5. In Cartelle, seleziona dove salvare il modello.
6. Clicca su Salva.
7. Se la catena ha delle variabili, imposta ogni variabile del modello:
   

   • Inserisci il nome predefinito della variabile modello.

     Suggerimento: Per identificare il valore da utilizzare con una variabile, ti consigliamo di includere un prefisso nel suo nome. Ad esempio, WSV- per una variabile dello spazio di lavoro, CV- per una variabile di catena, DCV- per una variabile dinamica di catena o Resource- per una risorsa dello spazio di lavoro.

   • Per facilitare la portabilità e il riutilizzo, elimina i valori predefiniti.

   • Seleziona se una variabile di catena dinamica o una risorsa dello spazio di lavoro fornirà il valore.

     Nota: Se il valore è fornito da una variabile di catena, una variabile dello spazio di lavoro o una variabile di runtime, non selezionare né Dynamic né Resource.

8. Clicca su Salva e Pubblica.

Creare un modello da zero

Per creare una nuova sequenza di comandi ed eventi come struttura riutilizzabile per le catene, segui la seguente sequenza di passi.

Passo 1: Aggiungere il modello

1. In Chain Builder, dalla scheda Templates dynamic_feed , clicca Create => Template in alto a destra.
2. Per creare il modello in un luogo diverso dalla cartella Default, clicca su Modifica modifica per la sua cartella, seleziona la cartella in cui salvare il modello e clicca su Sposta.

3. Inserisci un nome e una descrizione unici per identificare il modello e il suo scopo.

   Suggerimento: Per identificare se un modello fornisce una sequenza per una catena completa o parziale, includi un prefisso nel suo nome. Ad esempio, Full- per una catena completa, oppure Part- per una catena parziale o un frammento.

Passo 2: Impostazione delle variabili del modello

Per facilitare la personalizzazione e il riutilizzo, i modelli contengono variabili come segnaposto per i valori richiesti dalle variabili dei comandi o dalle risorse dello spazio di lavoro. Quando crei una catena dal modello, le variabili e le risorse della catena sostituiscono le variabili del modello.

Per ogni variabile da includere nel modello:

1. In Variabili del modello, clicca su Aggiungi.

2. Inserisci il nome della variabile e il valore predefinito.

   Suggerimento: Per identificare il valore da utilizzare con una variabile modello, ti consigliamo di includere un prefisso nel suo nome. Ad esempio, WSV- per una variabile dello spazio di lavoro, CV- per una variabile di catena, DCV- per una variabile di catena dinamica o Resource- per una risorsa dello spazio di lavoro.

3. Alla voce Tipo, seleziona se il valore della variabile sarà fornito da una variabile di catena dinamica o da una risorsa dello spazio di lavoro.

   Nota: Se una variabile di catena, una variabile dello spazio di lavoro o una variabile di runtime fornisce il valore, non selezionare né Dynamic né Resource.

Dopo aver aggiunto tutte le variabili al modello, clicca su Salva.

Nota: Per rimuovere una variabile dal modello, clicca su X sotto Azioni.

Passo 3: Definire i nodi del modello

Quando costruisci un modello, imposta e collega i nodi della sua sequenza:

• Comandi o attività eseguite da catene create dal modello, ad esempio per interagire con la piattaforma Workiva o un'altra fonte di dati.
• Eventi che si verificano all'interno del modello, ad esempio per attivare un flusso di lavoro di approvazione o il caricamento manuale di file.
• Eventi di attivazione, come gli input di runtime per impostare le variabili, ad esempio su conti, regioni o periodi di tempo specifici, quando esegui le catene create dal modello, oppure per avviare automaticamente la catena in base alle modifiche delle fonti collegate.

Nota: Per consentire la personalizzazione e il riutilizzo, i comandi di un modello non utilizzano le connessioni, i corridori o le variabili impostate nella catena o nell'area di lavoro; le specificherai quando creerai una catena dal modello.

Aggiungere nodi

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

• Per aggiungere il primo nodo del modello, spostalo in Inizia.
• Per aggiungere un nodo come inizio di un nuovo ramo di un albero logico, collega il passo precedente del modello al primo nodo dei rami multipli.
• Per eseguire i comandi in parallelo tra loro o insieme come parte di un processo seriale, 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 link e seleziona la sua condizione: successo check_circle, fallimento errore, avvertimento warning, o qualsiasi check_circle.

Dopo aver definito i nodi del modello, clicca su Pubblica.

Modifica le impostazioni di un modello

Per modificare il nome o la descrizione di un modello o per gestire le sue variabili:

1. In Chain Builder, dalla scheda Templates dynamic_feed, clicca sul nome del modello e Template Settings.
2. Modifica il nome, la descrizione o le variabili del modello come necessario.
3. Clicca su Salva e Pubblica.

Visualizza le catene che utilizzano un modello

Per vedere quali catene sono state create da un modello, vai alla schedaTemplates dynamic_feed e poi clicca su View per il modello sotto Chains Using.

Nel pannello In uso appaiono le catene create dal modello. Per aprire una catena, clicca sul suo nome. 

Suggerimento: Per trovare una catena specifica, cerca il suo nome.

Copiare i modelli

Per utilizzare un modello come punto di partenza per un nuovo modello, creane una copia. In Chain Builder, dalla scheda Templates dynamic_feed, clicca su Copy file_copy per il modello.

Condividi i modelli con altri

Per aiutare altri a creare catene, puoi condividere i link ai modelli pubblicati con altre persone che utilizzano Chain Builder- compresi quelli di altre organizzazioni, ad esempio nella Workiva Community. 

1. In Chain Builder, dalla scheda Templates dynamic_feed, clicca sul link Get shareable link open_in_new.
   
2. Clicca su Copia negli appunti file_copy e Chiudi.
3. Incolla e condividi il link con altri utenti, se necessario.

Tieni presente che i modelli dipendono dall'accesso di entrambi gli spazi di lavoro agli stessi connettori e comandi. Quando condividi un modello con un altro spazio di lavoro, la catena importata non funzionerà se non sono abilitati tutti i connettori richiesti.

Quando importi una catena, avrai la possibilità di configurare i connettori mancanti:

Revoca dell'accesso a un modello condiviso

Per revocare ad altri l'accesso a un modello condiviso, aggiorna il suo URL per creare un nuovo link:

1. In Chain Builder, dalla scheda Templates dynamic_feed, clicca su Get shareable link open_in_new per il modello.
2. Clicca su Rigenera token aggiorna e Chiudi.

Archiviare i modelli

Se non hai più bisogno di un modello, puoi archiviarlo. In Chain Builder, clicca su Templates dynamic_feed, e clicca su Archive archive per il modello.

Nota: Per visualizzare un modello archiviato da Templates, clicca su Archiviato.