Centro assistenza di Workiva

Questa guida fornisce istruzioni dettagliate per l'implementazione del modello " : Esegui query e scarica i risultati con foglio di controllo" ( ). Questo modello rappresenta un'alternativa al comando "Esegui query" ( ) , che in precedenza richiedeva agli utenti di inserire manualmente i parametri in sequenza prima della distribuzione e dell'esecuzione.

Utilizzando il foglio di controllo “ ” ( ), gli utenti possono aggiungere più ID di query e definire dinamicamente parametri quali “ ” (Pick-list) ( ) o “ ” (Selezione multipla) ( ). Questo modello viene solitamente integrato nelle catene esistenti, ma può essere utilizzato anche in qualsiasi flusso di lavoro che richieda risultati di query in formato CSV " " .

Prerequisiti

I seguenti connettori devono essere abilitati e configurati nel proprio spazio di lavoro.

• Configura il connettore Workiva
• Configura il connettore JSON
• Configurare il connettore Handlebars
• Configurare il connettore per le richieste HTTP “ ”
• Configurare il connettore di trasformazione tabulare di

È necessario creare le seguenti variabili di lavoro all'interno del proprio spazio di lavoro:

• URL di base wsv_API - IAM
• wsv_Client ID
• wsv_Client Secret
• URL di base di wsv_API - Wdata

Trova il modello

Il modello “ : Esegui query e scarica risultati con foglio di controllo” ( ) si trova nella sezione “Workiva Chains” della schermata “Modelli per l’analisi di dati di mercato” ( Templates) .

Ecco come trovarlo:

1. In Chain Builder, vai alla scheda Templates dynamic_feed .
2. Seleziona Catene di Workiva dal menu in alto.
3. Cerca " 0.0 Execute a Query | Top-Level Orchestration" in alto a destra e apri il modello.

4. Dopo aver individuato il modello, clicca su New Chain per distribuirlo nel tuo spazio di lavoro. 

   Nota: Una volta configurata, ogni catena di questo modello deve essere pubblicata nell'area di lavoro.

    

Variabili

Input di runtime

Configura il template

Questo modello è costituito da due catene: “ ” 0.0 “Esegui una query | Orchestrazione di primo livello” e “ ” 0.1 “Esegui una query | Scarica i risultati” . Quando la catena primaria viene distribuita nell'area di lavoro, la catena secondaria viene distribuita automaticamente insieme ad essa. 

• Orchestrazione di primo livello : Sulla base delle informazioni contenute nella scheda di controllo, questa catena determina se una query utilizza un unico tipo di parametro ( , Pick List o , Multi-Select ) oppure più tipi di parametro (sia , Pick List che , Multi-Select ).
• Esegui una query | Scarica i risultati: Questa sequenza esegue una query utilizzando i parametri specificati e recupera i dati corrispondenti. Una volta eseguita la query, i risultati verranno scaricati in formato CSV per ulteriori analisi o utilizzi.

Una volta configurato il foglio di controllo “ ” ( ) e distribuito il modello di catena “ ” ( ) nel proprio spazio di lavoro, sono sufficienti l’ID del foglio di calcolo “ ” ( ) e l’ID del foglio “ ” ( ) del foglio di controllo.

Questi valori devono essere aggiunti come input di runtime dell' per la catena di orchestrazione di primo livello .

Configurazione del foglio di controllo in base al tipo di parametro

La configurazione del foglio di controllo dipende dai tipi di parametro definiti nella query Wdata. Se una query include più tipi di parametri (ad esempio, sia Pick List che Multi-Select ), ogni parametro deve essere definito su una riga separata utilizzando lo stesso ID della query . Se una query utilizza un solo tipo di parametro , il foglio di controllo richiede una singola riga per quella query.

Gli esempi riportati di seguito illustrano entrambi gli scenari.

Esempio: query con più tipi di parametri

Per una query che richiede sia il parametro " " (Elenco di selezione) sia il parametro " " (Selezione multipla) , il foglio di controllo deve includere righe separate per ciascun parametro , tutte con lo stesso ID query .

Nota: La colonna " " ( ) si riferisce al nome del parametro " " ( ) definito nella query Wdata.

Esempio di configurazione:

Esempio: query con un unico tipo di parametro

Per una query che utilizza un solo tipo di parametro , ovvero , il foglio di controllo dovrebbe contenere una singola riga per quell’ID query.

Ad esempio, se la query utilizza solo un parametro " " (Elenco di selezione) :

Assicurarsi che la scheda di controllo sia configurata correttamente, poiché un’impostazione errata potrebbe causare problemi a valle.

Caricamento dei dati in una tabella

È possibile automatizzare il processo di caricamento dei dati di output direttamente in una tabella. Per caricare i dati di output in una tabella, si consiglia di utilizzare il modello “ ” Caricare i dati in Wdata “ . È possibile attivare questa operazione nell'ambito del proprio processo aggiungendo un evento " " della catena di esecuzione nel connettore HTTP che scarica i risultati.

Risoluzione dei problemi

Per visualizzare la cronologia dell'esecuzione della catena, compresi gli errori:

1. Vai alla scheda Monitor di Chain Builder.
   

2. Passa il mouse sul punto interrogativo per visualizzare lo stato dell'esecuzione della catena.

      

Se la catena ha generato un errore o non è riuscita a scaricare i risultati di una query, eseguire le seguenti verifiche:

• Verifica che entrambe le catene siano state pubblicate nel tuo spazio di lavoro. Ogni catena deve essere pubblicata separatamente.
• Assicurarsi che la query in Wdata sia aggiornata all'ultima versione.
• Quando si inseriscono l'ID della query , il tipo , le chiavi e il valore nel foglio di controllo , assicurarsi che l'ID sia stato inserito per intero e che non vi siano spazi vuoti all'inizio o alla fine. Inoltre, verifica che le chiavi e i valori corrispondano correttamente ai parametri utilizzati in Wdata.
• Assicurarsi che la concessione OAuth2 " " associata alla connessione Workiva disponga dei diritti di accesso appropriati.
• Assicurarsi che tutti i parametri utilizzati in una query siano inclusi nel foglio di controllo.

Risorse aggiuntive

• Connettore Workiva
• Connettore Utilità dei file
• Connettore JSON
• Connettore Trasformazione tabellare
• Esegui una catena all'interno di un'altra catena ("Esegui eventi a catena")
• Autorizzazioni OAuth2
• Limiti delle caratteristiche e delle API di Wdata