Sappiamo che raccogliere i dati nel formato ottimale è essenziale per ottimizzare i cicli di reporting end-to-end. Il modo più efficiente per raccogliere e aggregare i dati in Wdata è utilizzare le query. In questo Percorso Didattico Collegato impareremo come eseguire una Query Wdata utilizzando le Catene, automatizzando la raccolta dei dati.
| Caso d'uso primario | Reporting su dati archiviati in Wdata |
| Obiettivo di apprendimento primario | Eseguire una query da una catena |
| Obiettivi didattici secondari | Esportare i risultati della query in un foglio di calcolo |
| Prerequisiti |
Completa CLP | Crea una query con un campo calcolato Identificare l'ID della query CLP Dettaglio dipendenti Facoltativo - Identifica l'URL di un foglio di calcolo esistente su cui scrivere i risultati della query |
| Modello di supporto | CLP | Eseguire una query ed esportare i risultati |
Passo 1: Creare una catena
- Aggiungi una nuova catena
- Nomina la catena: CLP | Esegui una query ed esporta i risultati
- Salva la catena
Passo 2: input di runtime
Utilizziamo l'evento Runtime Inputs Chain per avviare la catena. Questo ci permette di richiedere all'utente l'ID della query e l'URL del foglio di calcolo in cui scrivere i risultati. Il campo URL del foglio di calcolo è facoltativo; se viene lasciato vuoto, verrà creato un nuovo foglio di calcolo.
- Aggiungi un Runtime Inputs Evento a catena da Chain Trigger Events nell'area Start
- Consente di richiedere all'utente l'ID della query e l'URL del foglio di calcolo in cui verranno scritti i risultati.
- Per saperne di più sugli input di Runtime
- Modifica la catena di eventi Runtime Inputs facendo doppio clic sul comando
- Aggiungi gli ingressi sottostanti:
- Ingresso 1:
- Tipo: Campo di testo
- Nome visualizzato: ID Query
- Richiesto: Controllato
- Ingresso 2:
- Tipo: Campo di testo
- Nome di visualizzazione: URL del foglio di calcolo
- Richiesto: Deselezionato
- Ingresso 1:
- Aggiungi gli ingressi sottostanti:
- Salva il comando
Passo 3: Eseguire la query
Per recuperare i dati più recenti, è necessario eseguire la Query. Una volta che la query è stata eseguita con successo, possiamo esportare i risultati della query per utilizzarli nella reportistica o per inviarli ad altri sistemi esterni. Utilizzeremo il comando Esegui query per eseguire la query Wdata.
- Aggiungi un Comando Run Query dal Connettore Workiva all'area di disegno della catena
- Collega l'evento di catena Runtime Inputs al comando Run Query
- Fai doppio clic sul comando per configurarlo
- Clicca sul campo Query ID
- Nel pannello delle variabili di sinistra, clicca sulla freccia rivolta verso il basso per espandere l'opzione Trigger.
- Clicca sulla freccia rivolta verso il basso per espandere Runtime Inputs
- Clicca su Query ID
- Clicca sul campo Query ID
- Salva il comando
Passo 4: Esportazione dei risultati della query
Il secondo passo necessario per utilizzare i risultati della query è esportare i dati in un foglio di calcolo. Il comando Esporta risultati della query viene utilizzato per scrivere i risultati dell'esecuzione della query in un foglio specificato all'interno di un foglio di calcolo.
- Aggiungi un comando Esportazione dei risultati della query dal connettore Workiva all'area di disegno a catena
- Collega il comando Run Query al comando Export Query Results
- Fai doppio clic sul comando per configurarlo
- Clicca sul campo Query Result ID
- All'interno del pannello delle variabili di sinistra, clicca sulla freccia rivolta verso il basso per espandere Esegui query
- Clicca sulla freccia rivolta verso il basso per espandere i risultati della query
- Clicca su Id
- Clicca sul campo Query Result ID
Suggerimento. Se hai bisogno di utilizzare i risultati della tua query in un comando successivo, utilizza il comando Scarica i risultati della query dal Workiva Connector, utilizzando lo stesso ID della query di cui sopra come input per il campo ID risultato della query.
-
- Clicca quindi sul campo Spreadsheet URL
- Nel pannello delle variabili di sinistra, clicca sulla freccia rivolta verso il basso per espandere l'opzione Trigger.
- Clicca sulla freccia rivolta verso il basso per espandere il campo Ingressi Runtime
- Clicca su URL del foglio di calcolo
- Clicca quindi sul campo Spreadsheet URL
- Salva il comando
Passo 5: Prova l'esercizio
Ora che la Catena è completa, verifica il risultato
- Pubblica la catena
- Clicca su Esegui e poi seleziona Esegui con gli input
- Aggiungi i valori per i tuoi input di runtime
- Query ID - ID della query di dettaglio dei dipendenti CLP
- URL del foglio di calcolo - URL completo del foglio di calcolo in cui desideri esportare i risultati della query
- In questo esempio, nella Piattaforma Workiva è stato creato un foglio di calcolo denominato CLP Employee Totals.
- Una volta completata la catena, visualizza il foglio di calcolo per verificare i risultati.
- La catena dovrebbe aver eseguito correttamente la query ed esportato i risultati nel foglio di calcolo.
- Puoi verificare che i dati siano stati esportati nel tuo foglio di calcolo navigando verso l'URL del foglio
Per saperne di più sull'esecuzione delle query utilizzando le catene, completa il percorso successivo: Eseguire una query con un parametro!