Per dare agli utenti finali la possibilità di vedere i dati più aggiornati disponibili all'interno della Piattaforma Workiva, l'aggiornamento delle connessioni è essenziale. In questo Percorso didattico collegato, impareremo a creare una catena che aggiorna una connessione tra la Piattaforma Workiva e Wdata utilizzando l'ID della connessione. Nei percorsi successivi scopriremo come estrarre automaticamente l'ID della connessione e aggiornare la connessione utilizzando le catene.
| Caso d'uso primario | Connettività dei dati tra Workiva e Wdata |
| Obiettivo di apprendimento primario | Scopri come aggiornare una connessione utilizzando le catene |
| Prerequisiti |
Configurare Workiva Connector Completa CLP | Caricare i dati in un percorso tabellare Completa CLP | Creare una query con un campo calcolato Fornisci i permessi al foglio di calcolo per l'utente Workiva OAuth Grant associato |
| Modello di supporto | CLP | Aggiorna connessione usando l'ID |
Nota: la query CLP Dettaglio dipendenti è necessaria per questa connessione. Segui le istruzioni CLP | Crea una query con un campo calcolato per creare la query. Se tutti i percorsi di gestione delle query sono stati completati, vai alla sezione Parametri della query CLP Employee Details e segui questi passaggi per eliminare il parametro Paese.
Passo 1: 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.
- Naviga nella Piattaforma Workiva per creare un nuovo Foglio di calcolo
- Clicca su Crea e seleziona Foglio di calcolo
- Dai un nome al foglio di calcolo: Panoramica dei dipendenti CLP
- Nome del primo foglio: Dettagli del dipendente CLP
- Aggiungi una connessione in entrata al foglio Dettagli dipendenti CLP:
- Apri il pannello Connessioni sulla destra cliccando sull'icona Connessioni
- Nella scheda Connessioni in arrivo, seleziona Aggiungi connessione
- Seleziona Query Wdata
- Seleziona la query CLP Dettaglio dipendenti
- Clicca su Connect
- Apri il pannello Connessioni sulla destra cliccando sull'icona Connessioni
Passo 2: Creare una catena
- Vai al Creatore di catene
- Aggiungi una nuova catena
- Dai un nome alla catena: CLP | Aggiorna la connessione usando l'ID
- Salva la catena
Passo 3: input di runtime
Utilizziamo l'evento di catena Runtime Inputs per avviare la catena. Questo ci permette di specificare quale connessione vogliamo aggiornare al momento dell'esecuzione della catena.
- 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 connessione
- Richiesto: Deselezionato
- Salva il comando
Passo 4: Aggiornare la connessione
Utilizzeremo il comando Aggiorna connessione per aggiornare la nostra connessione utilizzando l'ID della connessione.
- Aggiungi un comando Refresh Connection dal Workiva Connector all'area di disegno della catena
- Collega il Comando Runtime Inputs al Comando Refresh Connection
- Fai doppio clic sul comando per configurarlo
- Nome del comando: Aggiorna connessione
- Utilizza la variabile Connection ID da Runtime Inputs - questo ci permette di inviare al comando Refresh Connections il valore specificato durante l'esecuzione della Catena.
- Clicca sul campo ID connessione
- Nel pannello di sinistra, espandi il menu a tendina Trigger
- Espandi il menu a tendina Runtime Inputs
- Seleziona la variabile Connection ID
- Lascia le opzioni dei parametri così come sono, tratteremo i campi dei parametri in un percorso futuro.
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
- Trova l'ID della connessione
- Vai al foglio di calcolo di riepilogo dei dipendenti CLP
- Nel pannello delle connessioni, trova la connessione CLP Employee Detail 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 a Chain Builder e incolla l'ID della connessione nell'Input Runtime dell'ID della connessione.
- Clicca su Avvia
- Una volta completata la catena, torna alla tabella o al foglio di calcolo e vedi 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 le connessioni con un parametro!