Hai guardato il webinar Chains Foundations? Vuoi seguire il tuo ritmo? In questo Percorso Didattico Collegato, creeremo una Catena che scarica i dati da una fonte, li carica su una Tabella Wdata e aggiorna le connessioni, seguendo i passi compiuti durante il Webinar Chains Foundations.
| Caso d'uso primario | Automatizzare i flussi di lavoro di reporting |
| Obiettivo di apprendimento primario | Imparare i concetti fondamentali di Chains |
| Prerequisiti |
Completa i seguenti argomenti: |
| Modello di supporto | CLP | Chains Foundations |
Passo 1: Creare una catena
Per automatizzare lo spostamento dei dati di partenza verso i report finali, dobbiamo prima creare una Catena che orchestrerà il processo dall'inizio alla fine. Dato che utilizzeremo sempre lo stesso foglio di calcolo e la stessa tabella, imposteremo delle Variabili di Catena per memorizzare questi dettagli per un accesso coerente.
- Crea una nuova Catena , e dai un nome alla Catena: CLP | Chains Foundations.
-
In Variabili di Catena, clicca due volte sul segno più per creare due Variabili di Catena e configurarle come descritto di seguito:
Variabile 1:
- Tipo: Variabile a catena (cv)
- Nome: cv-Spreadsheet ID
- Valore:L'ID del foglio di calcolo della spesa aziendale CLP per reparto creato nel CLP Wdata Foundations.
- Per trovare l'ID del foglio di calcolo:
- Vai al foglio di calcolo Spesa dell'azienda CLP per reparto.
- 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 è indicato in grassetto qui: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
Variabile 2:
- Tipo: Variabile a catena (cv)
- Nome: cv-Table ID
- Valore: inserisci l'ID della Tabella Spesa Aziendale CLP.
- Per trovare l'ID della tabella:
- Vai alla Tabella delle spese aziendali del CLP .
- Nell'URL, seleziona l'ID della tabella, che si trova dopo "
table/".
Ad esempio, l'ID della tabella è indicato in grassetto qui: app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
- Salva la catena.
Passo 2: Scaricare il file
Il comando HTTP Request Get verrà utilizzato per scaricare il file che verrà caricato nella tabella. Abbiamo ospitato dei file online che la Catena può scaricare per dimostrare il download dei file dal cloud. Per rendere questo processo dinamico, aggiungeremo il periodo corrente all'URL, che corrisponde al mese in cui ci troviamo e ci garantirà l'estrazione del set di dati corrente.
- Aggiungi un comando Ottieni dal connettore HTTP Request all'area iniziale.
- Fai doppio clic sul comando per configurarlo.
- Popola il campo URL con il contenuto seguente, utilizzando una variabile per generare il mese corrente, che corrisponde al periodo:
https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv. - Sostituisci <System.DateTime> con la variabile di runtime per la data e l'ora del sistema.
- Nel pannello Seleziona una variabile, clicca sulla freccia verso il basso per espandere Runtime.
- Seleziona System.DateTime.
- Clicca sulla variabile System.DateTime per trasformarla. Usa i seguenti valori:
- Per Seleziona Trasformazione:, seleziona Parse Date/Time.
- Clicca sul pulsante +.
- Per il menu a tendina del formato :, seleziona ISO Extended (Platform Standard).
- Per Formato data di output:, seleziona %m.
Questo output significa che ci verrà fornito solo il mese a due cifre della data e dell'ora del sistema.
Per saperne di più sulle trasformazioni comuni di data e ora, clicca qui. - Nei campi Input date timezone e Output date timezone, seleziona il tuo fuso orario attuale.
- Clicca su ACCEPT.
- Popola il campo URL con il contenuto seguente, utilizzando una variabile per generare il mese corrente, che corrisponde al periodo:
- Aggiorna il campo Tipo di contenuto in: application/csv.
- Salva il comando.
Passo 3: Creare un file
Il caricamento di un file in una tabella Wdata è un processo in due fasi. Il file dovrà essere creato nello stato Staged prima di poter essere importato per l'uso finale. Utilizzeremo il comando Create File per creare il file all'interno della tabella Wdata nello stato Staged, che indica che è stato creato ma non ancora importato come set di dati.
- Aggiungi un comando Create File dal Workiva Connector all'area di disegno della catena.
- Collega il comando Get al comando Create File.
- Fai doppio clic sul comando per configurarlo.
- Clicca sul campo ID tabella.
- Nel pannello di sinistra Seleziona una variabile, clicca sulla freccia verso il basso per espandere la catena .
- Seleziona cv-Table ID.
- Clicca sul campo File.
- Nel pannello di sinistra Seleziona una variabile, clicca sulla freccia verso il basso per espandere GET.
- Seleziona Response.
- Popola il campo Name con le informazioni riportate di seguito, seguendo la stessa procedura seguita in precedenza per popolare il campo Period:
ERPSpendData<System.DateTime>.csv - Sostituisci <System.DateTime> con la variabile di runtime per la data e l'ora del sistema.
- Nel pannello di sinistra Seleziona una variabile, clicca sulla freccia verso il basso per espandere Runtime.
- Seleziona System.DateTime.
- Clicca sulla variabile System.DateTime per trasformarla.
- Per Seleziona la trasformazione, seleziona Parse Date/Time.
- Clicca sul pulsante + .
- Per Formato, selezionare ISO Extended (Platform Standard).
- Per Formato data di output, seleziona %m-%d-%Y@T%H:%M.
Questo output significa che ci verranno fornite solo la data e l'ora completa dell'esecuzione della Catena.
Per saperne di più sulle trasformazioni di data e ora più comuni, clicca qui. - Nei campi Input date timezone e Output date timezone, seleziona il tuo fuso orario attuale.
- Clicca su ACCEPT.
- Clicca sul campo ID tabella.
- Clicca su Salva per salvare il comando.
Passo 4: Importare il file nella tabella
La seconda fase del processo di caricamento dei file nelle tabelle Wdata consiste nell'importare i dati, rendendoli utilizzabili nelle query. Questo passo prende il file in fase di elaborazione e lo importa nella Tabella designata come set di dati.
- Aggiungi un comando Import File into Table dal Workiva Connector all'area di disegno della catena.
- Collega il comando Create File al comando Import File into Table.
- Fai doppio clic sul comando per configurarlo.
- Clicca sul campo ID tabella.
- Nel pannello di sinistra Seleziona una variabile, clicca sulla freccia verso il basso per espandere la catena .
- Seleziona cv-Table ID.
- Clicca sul campo ID file.
- Nel pannello di sinistra Seleziona una variabile, clicca sulla freccia verso il basso per espandere Crea file.
- Clicca sulla freccia verso il basso per espandere Risultato.
- Seleziona Id.
- Salva il comando.
Passo 5: 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 del foglio di calcolo con i dettagli relativi alla connessione, compreso l'ID della connessione.
- Aggiungi un comando List Connections dal Workiva Connector all'area di disegno della catena.
- Collega il comando Import File to Table al comando List Connections.
- Fai doppio clic sul comando per configurarlo.
- Tipo di destinazione: Foglio elettronico
- ID di destinazione: Usa la variabile ID del foglio di calcolo Chain
- Clicca sul campo ID di destinazione.
- Nel pannello delle variabili di sinistra, espandi il menu a tendina Chain.
- Seleziona la variabile ID foglio elettronico.
- Salva il comando.
Passo 6: Gruppo di comandi
Utilizzeremo un Gruppo di comandi per attivare l'iterazione su ogni connessione. L'iteratore di gruppo spingerà 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 delle connessioni
- Vai alla scheda Iterators.
- 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'output Connections.
- Salva il gruppo di comandi.
Passo 7: 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 dell'iteratore di gruppo al comando Refresh Connection.
- Fai doppio clic sul comando per configurarlo.
- Per 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 Connection ID.
- Nel pannello di sinistra, espandi il menu a tendina Group Iterator.
- Espandi la tendina Connections Iteration.
- Seleziona la variabile ConnectionId.
- Seleziona la casella di controllo Use Previous Source Parameters.
- Per 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 8: Prova l'esercizio
Ora che la Catena è completa, verifica il risultato.
- Pubblica la Catena.
- Clicca su Esegui e poi su Esegui la catena.
- Una volta completata la Catena, torna alla Tabella e vedi che i dati sono stati caricati, naviga nel Foglio di calcolo e vedi che la connessione si è aggiornata con successo.