Centro assistenza di Workiva

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

Questi template ti permetteranno di creare una sequenza pre-costruita di comandi ed eventi da utilizzare per altre catene. Ad esempio, con i template 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 template con più catene, workspace e ambienti in Generatore di catene.

Creare un template da una catena esistente

Creare un template 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 Generatore di catene- inclusi quelli di altre organizzazioni, come ad esempio la Workiva Community. 

Per creare un template da una catena esistente:

1. Da Workiva, fai clic su Catene.
2. Seleziona la scheda Catene, quindi apri la catena che vuoi utilizzare come template.
3. Dal menu a tre puntini della catena in alto a destra, seleziona Crea template.
   
4. Inserisci un nome e una descrizione unici per identificare il template.
   
5. In Cartelle, seleziona dove salvare il template.
6. Clicca su Salva.
7. Se la catena ha delle variabili, imposta ogni variabile del template:
   

   • Inserisci il nome predefinito della variabile template.

     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 del workspace, CV- per una variabile di catena, DCV- per una variabile di catena dinamica o Resource- per una risorsa del workspace.

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

   • Seleziona se una variabile di catena dinamica o una risorsa del workspace fornirà il valore.

     Nota: se una variabile di catena, una variabile del workspace o una variabile di runtime fornisce il valore, non selezionare né Dinamico né Risorsa.

8. Clicca su Salva e Pubblica.

Creare un template 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 template

1. In Generatore di catene, dalla scheda Template dynamic_feed , clicca Crea => Template in alto a destra.
2. Per creare il template in un luogo diverso dalla cartella Predefinito, clicca su Modifica edit per la sua cartella, seleziona la cartella in cui salvare il template e clicca su Sposta.

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

   Suggerimento: per identificare se un template 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 template

Per facilitare la personalizzazione e il riutilizzo, i template contengono variabili come segnaposto per i valori richiesti dalle variabili dei comandi o dalle risorse del workspace. Quando crei una catena dal template, le variabili e le risorse della catena sostituiscono le variabili del template.

Per ogni variabile da includere nel template:

1. In Variabili del template, clicca su Aggiungi.

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

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

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

   Nota: se una variabile di catena, una variabile del workspace o una variabile di runtime fornisce il valore, non selezionare né Dinamico né Risorsa.

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

Nota: per rimuovere una variabile dal template, clicca su X sotto Azioni.

Passo 3: Definire i nodi del template

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

• Comandi o attività eseguite da catene create dal template, ad esempio per interagire con la piattaforma Workiva o un'altra fonte di dati.
• Eventi che si verificano all'interno del template, 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 template, 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 template non utilizzano le connessioni, i corridori o le variabili impostate nella catena o nel workspace; le specificherai quando creerai una catena dal template.

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 template, spostalo in Inizia.
• Per aggiungere un nodo come inizio di un nuovo ramo di un albero logico, collega il passo precedente del template 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 template, clicca su Pubblica.

Modifica le impostazioni di un template

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

1. In Generatore di catene, dalla scheda Template dynamic_feed, clicca sul nome del template e su Impostazioni template.
2. Modifica il nome, la descrizione o le variabili del template secondo necessità.
3. Clicca su Salva e Pubblica.

Visualizza le catene che utilizzano un template

Per vedere quali catene sono state create da un template, vai alla schedaTemplate dynamic_feed e poi clicca su Visualizza per il template in Utilizzo catene.

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

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

Copiare i template

Per utilizzare un template come punto di partenza per un nuovo template, creane una copia. In Generatore di catene, dalla scheda Template dynamic_feed, clicca su Copia file_copy per il template.

Condividi i template con altri

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

1. In Generatore di catene, dalla scheda Template dynamic_feed, clicca sul link Ottieni link condivisibile 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 template dipendono dall'accesso di entrambi i workspace agli stessi connettori e comandi. Quando condividi un template con un altro workspace, 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 template condiviso

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

1. In Generatore di catene, dalla scheda Template dynamic_feed, clicca su Ottieni link condivisibile open_in_new per il template.
2. Clicca su Rigenera token aggiorna e Chiudi.

Archiviare i template

Se non hai più bisogno di un template, puoi archiviarlo. In Generatore di catene, clicca su Template dynamic_feed e clicca su Archivia archive per il template.

Nota: per visualizzare un template archiviato da Template, clicca su Archiviato.