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 Chain Builder, organizzi e colleghi i compiti o i comandi che una catena deve eseguire.
Nota: Solo i proprietari dello spazio di lavoro o i proprietari delle catene possono accedere a Chain Builder. Da Wdata, clicca su Chains, quindi su Open Chain Builder.
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 impostato, puoi aggiungere la catena in Chain Builder:
- In Wdata, clicca su Chains , Chain Builder.
- Clicca su Costruisci, Catene, quindi clicca su Aggiungi, Crea catena nell'angolo in basso a destra.
-
Inserisci un nome e una descrizione unici per identificare la catena.
Nota: le catene di appaiono nel costruttore di catene di per tutti i membri dell'area di lavoro; nominatele in modo che i membri ne comprendano chiaramente l'intento. Per ulteriori informazioni sui nomi, consultare il sito Leading practice: Convenzioni di denominazione per le catene e i loro oggetti per ulteriori informazioni sulla denominazione.
- 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 all'area di lavoro. 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 Add 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 univoco e una descrizione 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:
Tasto 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:
- Fare clic su Pubblica, quindi su Pubblica.
- Fare clic su Esegui e poi su Esegui con gli 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.