Centro assistenza di Workiva

È possibile semplificare ulteriormente la gestione dei dati combinando i passaggi nella stessa catena. In questo Percorso Didattico Collegato ti illustreremo il modo migliore per sostituire i dati in una Tabella Wdata, un processo in due fasi che utilizza una catena.

Passo 1: Eseguire la catena

1. Vai alla catena CLP | Upload Data to a Table.
2. Clicca su Execute e poi seleziona Run With Inputs.
3. Inserisci i valori dei tuoi input di runtime:
   • ID della tabella - ID della tabella CLP Dettaglio dipendenti
     Consulta questo documento per trovare l'ID.
   • Nome file - qualsiasi nome tu voglia dare al file; in questo esempio, chiameremo il file "Dettaglio dipendenti".
   • Percorso del file - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv.
4. Clicca su Avvia.
5. Una volta completata la catena, clicca sul nodo Import File into Table per verificare il successo.
   Ora ci sono dati disponibili nella Tabella dei dettagli dei dipendenti CLP, che sostituiremo con il set di dati aggiornato, utilizzando un'unica catena per cancellare i vecchi dati e caricare i nuovi.

Passo 2: Creare una catena

1. Aggiungi una nuova catena .
2. Assegna un nome alla catena: CLP | Sostituisci i dati in una tabella.
3. Salva la catena.

Passo 3: Ingressi di Runtime

Utilizziamo il comando Runtime Inputs per avviare la Catena. Questo ci permette di specificare il nome del file e l'ID della tabella in cui verrà importato il file quando si esegue la Catena.

1. Aggiungi un comando Runtime Inputs dagli Eventi Trigger della Catena nell'area di avvio.
2. Modifica l'evento a catena Runtime Inputs facendo doppio clic sul comando.
   Aggiungi i tre ingressi seguenti:
   • Ingresso 1:
     • Tipo: Campo di testo
     • Nome visualizzato: ID tabella
     • Richiesto: Controllato
   • Ingresso 2:
     • Tipo: Campo di testo
     • Nome visualizzato: Nome del file
     • Richiesto: Controllato
   • Ingresso 3:
     • Tipo: Campo di testo
     • Nome visualizzato: Posizione del file
     • Richiesto: Controllato
3. Salva il comando.

Passo 4: Elenco dei file

Per eliminare il vecchio file nella Tabella, abbiamo bisogno dell'ID del file. Per trovare programmaticamente il FileID, utilizzeremo il comando Elenca file. Questo comando utilizza l'ID della Tabella per cercare tutti i file all'interno di quella Tabella e ci fornisce un output dei file e delle informazioni su di essi, compreso l'ID del file.

1. Aggiungi un comando List Files all'area di disegno della catena
2. Collega l'evento a catena Runtime Inputs al comando List Files.
3. Fai doppio clic sul comando per configurarlo e clicca sul campo ID tabella.
4. Nel pannello di sinistra Variables, clicca sulla freccia verso il basso per espandere Trigger.
   1. Clicca sulla freccia rivolta verso il basso per espandere Runtime Inputs.
   2. Seleziona TableID.
5. Salva il comando.

Passo 5: Disimportare il file dalla tabella

Come per il caricamento dei dati in una tabella, anche l'eliminazione dei dati da una tabella è un processo in due fasi. Prima di poter essere cancellato, il file dovrà essere spostato nello stato di staged. Per impostare il file come staged, è necessario disimportarlo. Utilizzeremo il comando Un-Import File from Table per preparare il set di dati da cancellare.

1. Aggiungi un Comando Un-import File from Table all'area di disegno Catena.
2. Collega il comando List Files al comando Un-import File from Table.
3. Fai doppio clic sul comando per configurarlo.
   1. Clicca sul campo ID tabella.
      1. Nel pannello di sinistra Variables, clicca sulla freccia verso il basso per espandere Trigger.
      2. Clicca sulla freccia rivolta verso il basso per espandere Runtime Inputs.
      3. Seleziona TableID.
   2. Clicca sul campo File ID.
      1. Nel pannello delle variabili a sinistra, clicca sulla freccia verso il basso per espandere List Files.
      2. Seleziona List Files.
      3. Clicca sulla variabile List Files - Files List per trasformare la variabile.
         1. Clicca su Seleziona la trasformazione e poi seleziona Ottieni valore da JSON.
         2. Clicca sul segno più per aggiungere la trasformazione variabile.
         3. Nel campo Valore digita '0' e poi premi Inserisci.
         4. Dopo la comparsa di =0, digita 'id' e premi Inserisci di nuovo.
            La variabile ora leggerà l'output JSON del comando List Files e troverà l'id del primo file nella tabella.

            Suggerimento! Presta particolare attenzione alle maiuscole e alle minuscole quando analizzi i valori JSON.

         5. Clicca su Accetta.
            
   3. Salva il comando.
      

    

   Passo 6: Scaricare il file

   Successivamente, possiamo eliminare il file in fase di staged dalla Tabella oppure preparare il nuovo file da caricare. Ti consigliamo di caricare un nuovo file dopo aver disimportato il vecchio file per assicurarti che il processo vada a buon fine prima che i dati vengano ufficialmente cancellati.

   Per preparare il nuovo file per il caricamento, dovremo prima scaricare il file utilizzando il comando HTTP Request Get. Abbiamo messo online un file che la Catena può scaricare per dimostrare il download di file dal cloud.

   1. Aggiungi un comando Get dal connettore HTTP Request all'area di disegno della catena.
   2. Collega il comando Un-import File from Table al comando Get.
   3. Fai doppio clic sul comando per configurarlo.
      
      1. Clicca sul campo URL.
         1. Nel pannello di sinistra Seleziona una variabile, clicca sulla freccia verso il basso per espandere Trigger.
         2. Clicca sulla freccia rivolta verso il basso per espandere Inputs Runtime.
         3. Seleziona Posizione del file.
      2. Aggiorna il campo Tipo di contenuto in: application/csv.
   4. Salva il comando.

   

   Passo 7: Creare il file

   Proprio come abbiamo fatto nel percorso di apprendimento Upload Data to Table Connected, seguiremo il processo in due fasi per caricare i dati su Wdata Tables. 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.

   1. Aggiungi un comando Create File dal Workiva Connector all'area di disegno della catena.
   2. Collega il comando Get al comando Create File.
   3. Fai doppio clic sul comando per configurarlo.
      
      1. Clicca sul campo ID tabella.
         1. Nel pannello di sinistra Seleziona una variabile, clicca sulla freccia verso il basso per espandere Trigger.
         2. Clicca sulla freccia rivolta verso il basso per espandere Ingressi Runtime.
         3. Seleziona Table ID.
      2. Clicca sul campo File .
         1. Nel pannello di sinistra Seleziona una variabile, clicca sulla freccia verso il basso per espandere GET.
         2. Seleziona Response.
      3. Clicca sul campo Nome.
         1. Nel pannello di sinistra Seleziona una variabile , clicca sulla freccia verso il basso per espandere Trigger.
         2. Clicca sulla freccia rivolta verso il basso per espandere Runtime Inputs.
         3. Seleziona Nome file.
         4. Nel pannello di sinistra Seleziona una variabile , clicca sulla freccia verso il basso per espandere Runtime.
         5. Seleziona Chain.ExecutionDateTime.
         6. Digita ".csv" dopo le due variabili.
            La variabile Chain.ExecutionDateTime serve a mostrare quando è stato generato il file e a garantire che ogni file abbia un nome univoco.

   

   Passo 8: Importare il file nella tabella

   La fase successiva 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 preparazione e lo importa nella Tabella designata come set di dati.

   1. Aggiungi un Comando Importa file nella tabella dal Connettore Workiva all'area di disegno della catena.
   2. Collega il comando Create File al comando Import File into Table.
   3. Fai doppio clic sul comando per configurarlo.
      
      • Per il campo ID tabella:
        1. Nel pannello di sinistra Seleziona una variabile , clicca sulla freccia verso il basso per espandere Trigger.
        2. Clicca sulla freccia rivolta verso il basso per espandere Runtime Inputs.
        3. Seleziona ID tabella.
      • Per il campo ID file.
        1. Nel pannello di sinistra Seleziona una variabile , clicca sulla freccia verso il basso per espandere Crea file.
        2. Seleziona Risultato.
        3. Clicca su Create File - Result per trasformarlo.
           1. Nel menu a tendina Seleziona la trasformazione, seleziona Ottieni valore da JSON.
           2. Clicca sul pulsante + (più).
           3. Nel campo Valore, digita "id" e premi Digita.
           4. Clicca su ACCETTA.
   4. Salva il comando

   

   Passo 9: eliminare il file

   Ora che i nuovi dati sono stati caricati e sono pronti per essere utilizzati e che il vecchio set di dati è stato messo in scena, il passo finale è quello di cancellare ufficialmente i vecchi dati. Questo passaggio utilizza il comando Delete File per eliminare il set di dati dalla tabella.

   1. Aggiungi un Comando Delete File dal Connettore Workiva all'area di disegno a catena
   2. Collega il comando Importa file nella tabella al comando Elimina file
   3. Fai doppio clic sul comando per configurarlo.
      Per assicurarci di eliminare lo stesso file che abbiamo disimportato, genereremo l'ID del file nello stesso modo in cui abbiamo fatto per il comando Un-import File from Table:
      • Nel campo ID file:
        1. Nel pannello di sinistra Variables, clicca sulla freccia verso il basso per espandere List Files.
        2. Seleziona List Files.
        3. Clicca sulla variabile List Files - Files List per trasformare la variabile.
           1. Clicca su Seleziona trasformazione e poi seleziona Ottieni valore da JSON.
           2. Clicca sul segno più (+) per aggiungere la trasformazione della variabile.
              1. Nel campo Value digita "0" e poi premi Enter.
              2. Dopo la comparsa di =0, digita "id" e premi Inserisci di nuovo .
                 La variabile ora leggerà l'output JSON del comando List Files e troverà l'id del primo file nella tabella.

                 Suggerimento! Presta particolare attenzione alle maiuscole e alle minuscole quando analizzi i valori JSON.

              3. Clicca su Accetta
                 
              4. Salva il comando.xx
                 

               

              Passo 10: Prova l'esercizio

              Ora che la Catena è completa, verifica il risultato.

              1. Clicca su Esegui e seleziona Esegui con gli input.
              2. Aggiungi i valori per i tuoi input di runtime.
                 • ID tabella - ID della tabella CLP Employee Detail
                   Consulta questo documento per trovare l'ID
                 • Nome file - qualsiasi nome tu voglia dare al file; in questo esempio, chiameremo il file "Dettaglio dipendenti".
                 • Posizione del file - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
              3. Clicca su Avvia
                 • La catena dovrebbe aver rimosso il vecchio file e averlo sostituito con il nuovo nella tabella.
                 • Puoi verificare che i dati siano stati sostituiti nella tua tabella navigando nella Tabella in Wdata ed esaminando i Dataset nel pannello di destra.

              

              

              Per saperne di più sull'utilizzo delle catene per ottimizzare la raccolta dei dati, consulta il resto del sito Percorsi di centralizzazione dei dati!