Con le catene di , puoi automatizzare le attività di routine, con una facile integrazione per recuperare o inviare dati da più sistemi di record. Ad esempio, puoi creare una catena per estrarre automaticamente le informazioni finanziarie da un'origine dati in una tabella e poi inviarle a un altro sistema per generare un report. In Generatore di catene, organizzi e colleghi i compiti o i comandi che una catena deve eseguire.
Nota: solo i proprietari del workspace o i proprietari delle catene possono accedere a Generatore di catene.
Per aprire Generatore di catene, in Workiva fai clic su Catene, quindi fai di nuovo clic su Catene nella scheda Wdata.
Con gli esercizi di Iniziare con le tabelle e Iniziare con le query, crei tabelle e query come quelle utilizzate per il reporting finanziario. In questo esercizio, creiamo una catena per eseguire la query ed esportarne i risultati in Fogli di calcolo.
Passo 1. Ottieni l'ID e i parametri della query
Se non l'hai ancora fatto, scarica i dati di esempio ed esegui gli esercizi Iniziare con le tabelle e Iniziare con le query, in quanto utilizzerai la query nella catena. Prendi nota dell'ID della query, che è il modo in cui la identificherai nella catena.
Nota: Quando apri una query in Wdata, il suo ID appare dopo /queries/ nel suo URL.
Se hai creato i filtri della query con parametri invece che con valori statici, prendi nota anche dei nomi dei parametri. Ad esempio:
- PY o Anno_precedente
- CY o Anno_Corrente
- Periodo_corrente
Passo 2. Creare il foglio di calcolo
Prima di creare la catena, crea un foglio di calcolo in cui esportare i risultati della ricerca.
Per evitare un uso improprio del foglio di calcolo, identifica chiaramente il suo scopo educativo nel nome.
Dopo aver creato il foglio di calcolo, prendi nota del suo URL; lo userai per identificare dove esportare i risultati della ricerca.
Passo 3. Creare la catena
Ora è il momento di creare la catena! Alla fine, includerà i comandi per eseguire la query ed esportare i suoi ultimi risultati in Fogli di calcolo.
Prima di creare una catena, verifica di aver configurato il connettore di Workiva utilizzato per eseguire i suoi comandi. Sebbene questa catena richieda un solo connettore, le catene possono utilizzare più connettori per preparare e trasferire i dati nei vari sistemi di record.
Con il connettore configurato, puoi aggiungere la catena:
- In Workiva, fai clic su Catene nell'area di navigazione a sinistra. Si apre una nuova scheda Wdata.
- In Wdata, fai clic su Catene.
- Seleziona l'ambiente in cui vuoi che la catena venga creata dal menu in cima alla pagina.
- Fai clic su Crea nell'angolo in alto a destra della pagina e seleziona Crea catena o Crea catena da template. Questa procedura presuppone che tu abbia selezionato Crea catena.
- Nella finestra di dialogo Modifica catena:
-
Inserisci un nome e una descrizione unici per identificare la catena.
Nota: le catene appaiono nel Generatore di catene per tutti i partecipanti al workspace; nominale in modo che i membri ne comprendano chiaramente l'intento. Fai riferimento a Best practice: Convenzioni di denominazione per catene e i loro oggetti per maggiori informazioni sulla denominazione.
- Seleziona se questa catena consentirà esecuzioni simultanee.
-
- Clicca su Salva.
Passo 4. Iniziare con un evento trigger Runtime Inputs
Per fare in modo che la catena inizi chiedendo le variabili necessarie per i suoi comandi, aggiungi un evento di attivazione Runtime Inputs .
Suggerimento: Oltre agli input di runtime, puoi aggiungere variabili alla catena o al workspace. Con le variabili puoi estendere l'uso di una catena, ad esempio con qualsiasi query o foglio di calcolo anziché solo una query o un foglio di calcolo specifico.
- Clicca su Eventi di attivazione , sposta Ingressi runtime a Avvia, e clicca Modifica .
- In Informazioni di base, inserisci un nome univoco e una descrizione per identificare l'evento.
-
In Variabili, aggiungi variabili per:
- L'ID della query
- Qualsiasi valore dei parametri della query
- L'URL del foglio di calcolo
Suggerimento: Per ogni variabile, clicca su Aggiungi input, seleziona TextField e inserisci il nome, la descrizione e il valore predefinito.
- Clicca su Salva.
Passo 5. Aggiungi un comando per eseguire la query
Poi, aggiungi un comando Esegui la query per fare in modo che la catena ottenga i risultati più recenti ogni volta che viene eseguita. Utilizzerai gli input di runtime per identificare l'ID e i valori dei parametri della query.
- In Connettori disponibili, seleziona Workiva e trascina Esegui query nell'area di disegno.
-
Trascina un link da Avvia a Esegui la query e clicca su Modifica.
Nota: Assicurati di collegare il comando a Avvia in modo che possa utilizzare gli input di runtime.
- In Informazioni di base, inserisci un nome e una descrizione univoci per identificare il comando.
- In Proprietà dei comandi, seleziona il connettore Workiva per eseguire il comando.
- Per Query ID, seleziona l'input runtime dell'ID della query sotto Trigger.
-
Se i filtri della query utilizzano valori di parametro, clicca su Aggiungi (+) sotto Parametri, e inserisci le loro coppie chiave/valore:
Chiave Valore PY o Anno_precedente In Trigger, seleziona l'input di runtime per l'anno precedente. CY o Anno_Corrente In Trigger, seleziona l'input di runtime per l'anno corrente. Periodo_corrente In Trigger, seleziona l'input di runtime per il periodo corrente. - Clicca su Salva.
Passo 6. Aggiungi un comando per esportare i risultati
Ora aggiungi un comando per esportare i risultati della query in Fogli di calcolo:
- In Connettori disponibili, seleziona Workiva, e trascina Esportazione del risultato della query nell'area di disegno.
- Trascina un link da Esegui la query a Esporta il risultato della query e clicca su Modifica per quest'ultima.
- In Informazioni di base, inserisci un nome e una descrizione univoci per identificare il comando.
- In Proprietà del comando, seleziona lo stesso connettore Workiva di Esegui la query.
- Per ID del risultato della query, seleziona ID per l'output del risultato della query sotto Esegui la query.
- Per URL del foglio di calcolo, seleziona l'input di runtime per l'URL del foglio di calcolo sotto Trigger.
- Clicca su Salva.
Passo 7. Esegui la catena
Per eseguire la catena:
- Fai clic su Pubblica, quindi di nuovo su Pubblica.
- Fai clic su Esegui, quindi su Esegui con input.
- Inserisci i valori degli input di esecuzione e clicca su Avvia.
- Per verificare che la catena abbia successo, controlla il foglio di calcolo per i risultati della query.
Se la catena non riesce, clicca sui comandi nella cronologia delle esecuzioni per esaminare i loro log alla ricerca di messaggi che ti aiutino a risolvere l'errore.