L'uso dei fogli di controllo è il modo più efficiente per memorizzare variabili distinte utilizzate per un singolo flusso di lavoro. I fogli di controllo sono utili per consentire agli utenti finali di specificare gli input di una Catena senza dover modificare la Catena stessa. Per utilizzare un foglio di controllo, dobbiamo prima capire come strutturare un foglio di controllo e come leggere i dati dal foglio di controllo. In questo Percorso Didattico Collegato, imposteremo un foglio di controllo e useremo un Comando Workiva per recuperare i dati dal foglio di controllo.
| Caso d'uso primario |
Orchestrazione dei flussi di lavoro di reporting da una postazione centralizzata Semplificare la gestione dei flussi di lavoro per gli utenti finali |
| Obiettivo di apprendimento primario | Impara a strutturare un foglio di controllo e a recuperare i dati da un foglio di controllo utilizzando le Catene |
| Prerequisiti |
Configurare Workiva Connector Completa il percorso CLP | Caricare i dati in una tabella Completa CLP | Aggiorna l'elenco delle connessioni Fornisci i permessi al foglio di calcolo per l'utente Workiva API Grant associato |
| Modello di supporto | CLP | Lettura da un foglio di controllo |
Passo 1: Creare un foglio di controllo
Creeremo un foglio di controllo per memorizzare le variabili utilizzate per caricare i dati in una tabella Wdata e poi aggiornare le connessioni per quei dati. Invece di specificare queste variabili come Runtime Inputs ogni volta che la Catena viene eseguita, aggiungeremo le nostre variabili a un foglio di controllo che la Catena leggerà e utilizzerà durante la sua esecuzione.
Sebbene questo foglio di controllo dimostri il caricamento di più file in una singola Tabella Wdata e l'aggiornamento delle connessioni in un singolo foglio di calcolo, il processo può essere ampliato per includere più Tabelle e fogli di calcolo semplicemente aggiungendo l'ID univoco della Tabella o del foglio di calcolo al foglio di controllo.
- 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: Foglio di controllo CLP
- Dai un nome al primo foglio: Foglio di controllo primario
- Nel Foglio di controllo primario, crea le seguenti intestazioni
- ActiveFlag
- Questa colonna specifica se il flusso di lavoro deve essere eseguito per quella riga del foglio di controllo.
- NomeFile
- Questa colonna indica il nome del set di dati come apparirà nella tabella Wdata
- TableID
- ID della tabella di Wdata in cui saranno caricati i dati
- SpreadsheetID
- ID del foglio di calcolo in cui i dati saranno aggiornati
- Posizione del file
- Posizione del file che verrà scaricato
- ActiveFlag
- Popola il foglio con i seguenti valori, riempiendo la colonna <TableID> con l'ID della tabella di dettaglio dei dipendenti CLP e la colonna <SpreadsheetID> con l'ID del foglio elettronico di riepilogo dei dipendenti CLP, questi ID sono stati creati nei precedenti percorsi di apprendimento connessi, fai riferimento ai prerequisiti per vedere i percorsi di apprendimento connessi richiesti.
ActiveFlag,FileName,TableID,FileLocation
TRUE,EmployeeDetailsP01,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
TRUE,EmployeeDetailsP02,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
TRUE,EmployeeDetailsP03,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv
Passo 2: Aggiornare i permessi del foglio di calcolo
Per garantire una comunicazione efficace tra un Comando di Workiva e un Foglio di calcolo, la Concessione API generata deve essere associata a un utente che possiede i permessi di proprietario o di editore del Foglio di calcolo.
- Dal Foglio di controllo CLP , clicca su File nella barra multifunzione in alto.
- Clicca su Permessi, poi su Foglio di calcolo
- Fornisci l'accesso all'utente di Workiva associato all'API Grant configurato all'interno della Workiva Connection.
Passo 3: Creare una catena
Per utilizzare le Variabili create nel foglio di controllo, creeremo una Catena che le legga. Dato che utilizzeremo sempre lo stesso foglio di calcolo e lo stesso foglio, imposteremo delle Variabili di Catena per memorizzare questi dettagli per un accesso coerente.
- Vai al Creatore di catene
- Crea una nuova catena
- Nome della Catena: CLP | Lettura da un foglio di controllo
- In Variabili di catena, clicca due volte sul segno più per creare due Variabili di catena e configurarle come segue:
- Variabile 1:
- Tipo: Variabile a catena (cv)
- Nome: cv-ID del foglio di controllo
- Valore: inserisci l'ID del foglio di calcolo del controllo CLP
- Per trovare l'ID del foglio di calcolo, vai al foglio di controllo 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: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Per trovare l'ID del foglio di calcolo, vai al foglio di controllo del CLP
- Variabile 2:
- Tipo: Variabile a catena (cv)
- Nome: cv-Nome del foglio di controllo
- Valore: Foglio di controllo primario
- Variabile 1:
- Salva la catena
Passo 4: Ottenere i dati del foglio
Utilizziamo il comando Ottieni dati del foglio per avviare la Catena. Questo ci permette di recuperare le informazioni dal foglio di controllo per alimentare la Catena.
- Aggiungi un Comando Ottieni Dati Foglio dal Connettore Workiva all'area di avvio della Catena
- Fai doppio clic sul comando per configurarlo
- Clicca sul campo ID del foglio di calcolo
- Nel pannello Seleziona una variabile, clicca sulla freccia verso il basso per espandere la catena
- Seleziona l'ID del foglio di calcolo cv-Control Variabile di catena
- Clicca sul campo ID/Nome del foglio
- Nel pannello Seleziona una variabile, clicca sulla freccia verso il basso per espandere la catena
- Seleziona il nome del foglio di controllo cv Variabile di catena
- Regione: puoi specificare una regione. Se lasciato come ":", il comando recupererà i dati nell'intero foglio di calcolo.
- Clicca sul campo ID del foglio di calcolo
- 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 catena
- Una volta completata la catena, clicca sul nodo Get Sheet Data per verificare l'esito del comando.
- Il comando dovrebbe fornire un output .csv dei dati all'interno del foglio specificato all'interno del foglio di calcolo; puoi vedere il .csv facendo clic sull'icona a forma di palla di occhio
Per saperne di più sull'uso dei fogli di controllo, completa il percorso successivo: Utilizzare i valori di un foglio di controllo!