Automatizzare l'aggiornamento delle connessioni è essenziale per semplificare la centralizzazione dei dati e il loro spostamento nella Piattaforma Workiva, soprattutto quando esistono più connessioni. In questo Percorso Didattico Collegato impareremo a creare una Catena che aggiorna un elenco di Connessioni tra Wdata e la Piattaforma Workiva utilizzando un ID del foglio di calcolo. Questa catena genera un elenco di connessioni su un singolo foglio di calcolo e ci fornisce l'elenco degli ID di tali connessioni, in modo da poter automatizzare l'aggiornamento di ogni connessione nel foglio di calcolo.
| Caso d'uso primario | Connettività dei dati tra Workiva e Wdata |
| Obiettivo di apprendimento primario | Imparare a rinfrescare un elenco di connessioni utilizzando le catene |
| Obiettivi didattici secondari | Imparare gli elementi essenziali degli iteratori di gruppo |
| Prerequisiti |
Completa CLP | Aggiorna le connessioni con un parametro Fornisci i permessi al foglio di calcolo per l'utente OAuth Grant associato |
| Modello di supporto | CLP | Aggiorna l'elenco delle connessioni |
Passo 1: Creare una catena
- Aggiungi una nuova catena
- Nomina la Catena: CLP | Aggiorna l'elenco delle connessioni
- Salva la catena
Passo 2: Ingressi in fase di esecuzione
Utilizziamo il comando Runtime Inputs per avviare la Catena. Questo ci permette di specificare per quale foglio di calcolo vogliamo aggiornare tutte le connessioni.
- Aggiungi un evento a catena Runtime Inputs da Chain Trigger Events il nodo iniziale
- Modifica l'evento a catena Runtime Inputs facendo doppio clic sul comando
- Tipo: Campo di testo
- Nome visualizzato: ID foglio di calcolo
- Richiesto: Selezionato
- Salva il comando
Passo 3: Elenco delle connessioni
Utilizzeremo il comando List Connections per recuperare l'elenco degli ID delle connessioni associate all'ID del foglio di calcolo. L'output del comando List Connections sarà un file JSON composto da ogni connessione nel foglio di calcolo con i dettagli relativi alla connessione, incluso l'ID della connessione.
- Aggiungi un Elenco Connessioni Comando dal Connettore Workiva all'area di disegno della catena
- Collega il Comando Runtime Inputs al Comando List Connections
- Fai doppio clic sul comando per configurarlo
- Tipo di destinazione: Foglio di calcolo
- ID di destinazione: Utilizza la variabile Spreadsheet ID da Runtime Inputs - questo ci permette di inviare il valore specificato al momento dell'esecuzione della Catena al comando Refresh Connections.
- Clicca sul campo ID di destinazione
- Nel pannello di sinistra, espandi il menu a tendina Trigger
- Espandi il menu a tendina Runtime Inputs
- Seleziona la variabile Spreadsheet ID
- Salva il comando
Passo 4: Gruppo di comandi
Utilizzeremo un gruppo di comandi per abilitare l'iterazione su ogni connessione. L'iteratore di gruppo farà passare ogni connessione sul foglio di calcolo attraverso i seguenti passaggi, uno alla volta.
- Aggiungi un Gruppo di Comandi all'area di disegno Catena
- Collega il Comando List Connections alla sezione In del Gruppo di Comandi
- Fai doppio clic sul comando per configurarlo
- Dai un nome al gruppo: Iterazione connessioni
- Vai alla scheda Iteratori
- Attiva la levetta Iterazioni e clicca sul campo Iterazioni
- Nel pannello Seleziona una variabile, clicca sulla freccia verso il basso per espandere Elenco Connessioni
- Seleziona l'uscita Connessioni
- Attiva la levetta Iterazioni e clicca sul campo Iterazioni
- Salva il gruppo di comandi
Passo 5: Aggiornare la connessione
Utilizzeremo il comando Aggiorna connessione per aggiornare le nostre connessioni utilizzando l'ID di connessione dell'iterazione.
- Aggiungi un Comando Refresh Connection dal Workiva Connector all'area di disegno della catena
- Collega la sezione Start dall'Iteratore di Gruppo al Comando Refresh Connection
- Fai doppio clic sul comando per configurarlo
- ID connessione: utilizza l'ID della connessione dall'iteratore Gruppo - Iterazione connessioni. Questo ci permette di aggiungere l'ID dell'iterazione corrente al comando Aggiorna connessioni.
- Clicca sul campo ID connessione
- Nel pannello di sinistra, espandi il menu a tendina Group Iterator
- Espandi il menu a tendina Iterazione delle connessioni
- Seleziona la variabile ConnectionId
- Usa i parametri della fonte precedente: Selezionato
- Questo ci permette di aggiornare una connessione utilizzando i valori dei parametri precedenti della fonte - nel nostro caso, la query con il parametro Paese verrà aggiornata con il Brasile come valore di filtro.
- ID connessione: utilizza l'ID della connessione dall'iteratore Gruppo - Iterazione connessioni. Questo ci permette di aggiungere l'ID dell'iterazione corrente al comando Aggiorna connessioni.
Passo 6: Prova 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 del foglio di calcolo
- Vai a Foglio di calcolo riassuntivo dei dipendenti del CLP
- Nell'URL, seleziona l'ID del foglio di calcolo, che si trova dopo "spreadsheet/" e prima di "/sheet".
- Ad esempio, l'ID del foglio di calcolo è in grassetto qui: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Torna a Chain Builder e incolla l'ID del foglio di calcolo nel campo ID del foglio di calcolo.
- Clicca su Avvia
- Una volta completata la catena, torna al foglio di calcolo e vedi che entrambe le connessioni sono state aggiornate con successo!
Esecuzione riuscita della catena con due iterazioni:
Aggiornamento della connessione riuscito:
Per saperne di più sull'utilizzo delle catene per ottimizzare la raccolta dei dati, consulta il resto del sito Percorsi di centralizzazione dei dati!