I parametri nelle query di Wdata rendono le query dinamiche e utilizzabili in tutti i periodi di riferimento. In questo Percorso Didattico Collegato, modificheremo la nostra Query aggiungendo un Parametro, rendendola dinamica, e poi modificheremo la nostra Catena per tenere conto del Parametro. Esporteremo i risultati della query in un foglio di calcolo di Workiva.
| Caso d'uso primario | Reporting su dati archiviati in Wdata |
| Obiettivo di apprendimento primario | Eseguire una query con un parametro di una catena |
| Obiettivi didattici secondari | Creare un parametro in una query |
| Prerequisiti |
Completa CLP | Crea una query con un campo calcolato Completa CLP | Esegui una query ed esporta i risultati Identificare l'ID della query CLP sul dettaglio dei dipendentiFacoltativo - Identifica l'URL di un foglio di calcolo esistente in cui scrivere i risultati |
| Modello di supporto | CLP | Esegui una query con un parametro |
Passo 1: Modifica della query esistente
Per prima cosa, dobbiamo modificare la nostra query CLP Employee Detail per aggiungere un parametro. Creeremo un parametro che ci permetta di decidere per quale Paese vogliamo vedere il conteggio totale dei dipendenti.
- Da Wdata, apri la Query CLP Employee Detail Query per modificarla
- Segui CLP | Crea una Query con un Campo Calcolato per creare la Query
- Nel pannello all'estrema destra, clicca sull'icona Parametri
- Clicca su Aggiungi parametri e seleziona Crea un nuovo parametro
- Dai un nome al parametro: Paese
- Passa il Pick List a abilitato
- Nel riquadro Opzioni elenco, elenca i seguenti Paesi, ognuno sulla propria riga:
- Australia
- Brasile
- Italia
- Kenya
- Stati Uniti
- Aggiorna il valore predefinito a Nessuno
- Clicca su Crea
- Affinché il Parametro controlli i risultati della nostra Query, dobbiamo collegare il Parametro alla colonna dei dati di origine utilizzando i Filtri. Vai alla scheda Filtri della Query.
- Individua la colonna Country dai Dati di origine a sinistra, clicca e trascinala nell'area dei filtri a sinistra.
- Clicca sul valore del filtro, dove c'è scritto Stringa vuota, per riempire il valore del filtro
- A destra del campo del valore del filtro, clicca sul pulsante dei parametri
- Seleziona Country
- Clicca su Applica
-
- Ora hai una Query con un parametro per il Paese; quando fai clic su Esegui Query, ti verrà chiesto quale Paese vuoi che vengano visualizzati i risultati della tua Query.
- Clicca su Salva
Passo 2: Modifica della catena esistente
- Vai al Chain Builder e individua la catena CLP | Esegui una query ed esporta i risultati
- Clicca sul pulsante con la matita per modificare la Catena
- Clicca su Impostazioni della catena in alto a destra
- Rinomina la catena: CLP | Esegui una query e con un parametro
- Salva la catena
Passo 3: input di runtime
Utilizziamo l'evento Runtime Inputs Chain per avviare la catena. Questo ci permette di richiedere l'ID della query da eseguire, il valore del suo parametro e l'URL di un foglio di calcolo esistente su cui scrivere i risultati. Il campo URL del foglio di calcolo è facoltativo; se viene lasciato vuoto, verrà creato un nuovo foglio di calcolo.
- Modifica l'evento a catena Runtime Inputs facendo doppio clic sul comando
- Clicca sul pulsante Add Input e aggiungi il seguente input:
- Tipo: Campo di testo
- Nome visualizzato: Valore del parametro della query
- Richiesto: Selezionato
- Facoltativamente, trascina questo nuovo input in modo che appaia dopo l'input dell'ID della query e prima dell'input dell'URL del foglio di calcolo.
- Salva il comando
Passo 4: 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.
- Fai doppio clic sul comando Esegui query per configurarlo
- Clicca sul pulsante ADD nella sezione Parameters
- Nel campo Name, digita il nome del parametro della query, in questo caso il nostro parametro si chiama Country.
- Nel campo Type, seleziona il tipo di parametro della query, in questo caso il nostro parametro è Text.
- Clicca sul campo Value
- Nel pannello delle Variabili di sinistra, clicca sulla freccia rivolta verso il basso per espandere Trigger
- Clicca sulla freccia rivolta verso il basso per espandere Ingressi Runtime
- Clicca su Query Parameter Value
- 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 in Wdata
- Valore del parametro della query - il valore su cui desideri filtrare la query
- In questo esempio - stiamo filtrando i dati su Brasile
- URL del foglio di calcolo - URL completo del foglio di calcolo in cui desideri esportare i risultati della query
- Una volta completata la catena, visualizza il foglio di calcolo per verificarne 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 e filtrati correttamente accedendo all'URL del foglio
Per saperne di più sull'utilizzo delle catene per ottimizzare la centralizzazione dei dati, consulta il resto dei percorsi di raccolta dati !