Centro assistenza di Workiva

Passo 1: Copiare la query esistente

Per prima cosa, abbiamo bisogno di una query con un parametro. Creeremo una copia della nostra query esistente e aggiungeremo un parametro che ci permetta di decidere per quale Paese vogliamo vedere il conteggio totale dei dipendenti.

• Dalla Home di Wdata, individua la Query CLP Employee Detail Query e apri il menu
  • Seleziona Copia

• Aggiorna il nome della query a Dettaglio dipendenti CLP per paese

• Clicca su Salva la query
• Dalla schermata di modifica della query, clicca sull'icona Parameters nel pannello all'estrema destra.

• Clicca su Aggiungi parametri e seleziona Crea 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
  • Fai clic su Creare
• 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: Creare una connessione in entrata

Per imparare ad aggiornare una connessione utilizzando una catena, dobbiamo prima stabilire una connessione tra una query Wdata e un foglio di calcolo. 

• Vai al foglio di calcolo Panoramica dei dipendenti CLP
• Aggiungi un nuovo foglio cliccando su
  • Rinominalo Dettagli dipendenti CLP per paese
• Aggiungi una connessione in entrata al foglio Dettagli dipendenti CLP per paese:
  • Apri il pannello Connessioni sulla destra facendo clic sull'icona Connessioni
  • Nella scheda Connessioni in arrivo, seleziona Aggiungi connessione
    • Seleziona Wdata Query
    • Seleziona la query CLP Dettaglio dipendenti per paese
    • Imposta il parametro Paese su Australia
    • Clicca su Connetti

• Ora ci sono due fogli con le connessioni in entrata nel foglio di calcolo CLP per la panoramica dei dipendenti.

Passo 3: Modifica della catena esistente

• Vai al Chain Builder e individua la catena CLP | Aggiorna la connessione usando l'ID
• Clicca sul pulsante con la matita per modificare la catena
• Clicca su Impostazioni della catena in alto a destra 
  • Rinomina la catena: CLP | Aggiorna le connessioni con un parametro
• Salva la catena

Passo 4: Ingressi di Runtime

Utilizziamo il comando Runtime Inputs per avviare la Catena. Questo ci permette di specificare la connessione che vogliamo aggiornare durante l'esecuzione della catena e il parametro di cui vogliamo aggiornare il valore.

• Modifica l'evento a catena Runtime Inputs facendo doppio clic sul comando
• Clicca due volte sul pulsante Add Input e aggiungi i seguenti ingressi:
  • Ingresso 1:
    • Tipo: Campo di testo
    • Nome visualizzato: Nome del parametro
    • Richiesto: Non selezionato
  • Ingresso 2:
    • Tipo: Campo di testo
    • Nome visualizzato: Valore del parametro
    • Richiesto: Deselezionato
• Salva il comando

Passo 5: Aggiornare la connessione

Per tenere conto del parametro aggiunto, dobbiamo aggiornare il comando Aggiorna connessioni per tenere conto del parametro e del valore che devono essere trasferiti alla query.

• Modifica Aggiorna la connessione facendo doppio clic sul comando
  • ID connessione: Continua a utilizzare la variabile Connection ID da Runtime Inputs
  • Aggiungi un parametro
    • Dato che i nostri parametri sono salvati all'origine (nella Query), vorremo popolarli all'origine. Clicca sul pulsante + accanto a Parametri Sorgente
    • Nome del parametro: Utilizza la variabile Parameter Name da Runtime Inputs - questo ci permette di inviare il valore del Parameter Name specificato durante l'esecuzione della Catena al Comando Refresh Connections.
      • Clicca sul campo Nome del parametro
      • Nel pannello di sinistra, espandi il menu a tendina Trigger
      • Espandi il menu a tendina Runtime Inputs
      • Seleziona la variabile Nome del parametro
    • Valore del parametro: Utilizza la variabile Parameter Value da Runtime Inputs - questo ci permette di inviare il valore del parametro specificato durante l'esecuzione della catena al comando Refresh Connections.
      • Clicca sul campo Nome del parametro
      • Nel pannello di sinistra, espandi il menu a tendina Trigger
      • Espandi il menu a tendina Runtime Inputs
      • Seleziona la variabile Parameter Value
• Salva il comando

Passo 6: Verifica l'esercizio

Ora che la Catena è completa, verifica il risultato

• Pubblica la catena
• Clicca su Esegui e poi seleziona Esegui con gli input
• Trova l'ID della connessione
  • Vai al foglio di calcolo di riepilogo dei dipendenti CLP di
  • Nel pannello delle connessioni, trova la connessione CLP Employee Detail by Country Query Connection e clicca sulla freccia in alto. Una volta visualizzato il menu a tendina, seleziona Visualizza proprietà

• Copia l'ID della connessione - assicurati di non perdere nessun carattere e di non aggiungere spazi

• Torna al Chain Builder e incolla l'ID della connessione nell'Input Runtime dell'ID della connessione.
• Popola gli input del parametro
  • Nome parametro: il nome del parametro nella query - in questo esercizio il nome del parametro è Paese
  • Valore del parametro: il valore su cui la query deve essere filtrata - in questa esercitazione filtreremo su Brasile
    • Nota: selezionando un valore di parametro diverso da quello già memorizzato nel foglio di calcolo, il foglio di calcolo verrà sovrascritto e i dati cambieranno da Australia a Brasile.
• Clicca su Avvia
• Una volta completata la catena, torna al foglio di calcolo e scopri che la connessione è stata aggiornata con successo!

Esecuzione della catena riuscita:

Aggiornamento della connessione riuscito:

Per saperne di più sull'aggiornamento delle connessioni utilizzando le catene, completa il percorso successivo: Aggiorna l'elenco delle connessioni!