Centro assistenza di Workiva

Semplificare il caricamento di un file di dati in una tabella Wdata è un'abilità fondamentale per ottimizzare la gestione delle tabelle. In questo Percorso Didattico Collegato spiegheremo come caricare i dati in una tabella Wdata usando le Catene.

Passo 1: Creare una tabella

1. Vai a Wdata
2. Completa i passaggi per creare una Tabella con le seguenti proprietà:
   • Nome tabella: "Dettaglio dipendente CLP"

   • Colonne:

     Mostrare nome	ID colonna	Tipo	Importare formato
     emp_id	emp_id	Testo
     nomeutente	nome_utente	Testo
     nome_utente	nome_nome	Testo
     cognome	cognome	Testo
     titolo del lavoro	titolo del lavoro	Testo
     reparto	reparto	Testo
     città	città	Testo
     paese	paese	Testo
     valuta	valuta	Testo
     data_assunzione	data_assunzione	Data	M/d/yyy
     fte	fte	Decimale	1,000.00
     terminato	terminato	Booleano

Note:

• Nota che il formato di importazione dei valori hire_date è stato modificato. Questo per far sì che corrisponda al formato dei dati che verranno caricati nella tabella. Puoi trovare informazioni sui formati di data/ora in questa pagina.
• Registra l'ID della tabella , che verrà utilizzato più avanti in questa procedura.

Passo 2: Creare una catena

1. Vai a Chain Builder.
2. Aggiungi una nuova catena .
3. Assegna un nome alla catena: CLP | Upload Data to a Table.
4. Salva la catena.

Passo 3: Ingressi di Runtime

Utilizza l'evento Runtime Inputs Chain per avviare la Catena. Questo ci permette di specificare il nome del file e l'ID della tabella in cui il file verrà importato quando si avvia la Catena. Per saperne di più sugli Input di Runtime.

1. Aggiungi un evento a catena Runtime Inputs da Chain Trigger Events al nodo iniziale.
2. Modifica l'evento a catena Runtime Inputs facendo doppio clic sul comando.
   • Aggiungi i valori dei tuoi Runtime Inputs.
     Questi saranno campi di testo e dovranno essere contrassegnati come "Richiesti".
     • ID tabella - ID della tabella "Dettaglio dipendenti CLP". 
       Consulta questo documento per trovare l'ID.
     • Nome del file - qualsiasi nome tu voglia dare al file.
       In questo esempio, chiama il file "Dettaglio dipendenti".
   • Percorso del file - Dove si trova il file CSV.
     Per questo esempio, usa: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
3. Clicca su Salva per salvare il comando.

Passo 4: Scaricare il file

Il comando HTTP Request Get verrà utilizzato per scaricare il file che verrà caricato nella tabella. 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 al canvas Chain.
2. Collega l'evento di catena Runtime Inputs 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 Runtime Inputs.
      3. Seleziona Posizione del file.
   2. Nel campo Tipo di contenuto seleziona: application/csv.
4. Salva il comando.

Passo 5: Creare un file

Il caricamento di un file in una tabella Wdata avviene 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.

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 Runtime Inputs.
      3. Seleziona ID tabella.
   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.
4. Salva il comando

Passo 6: 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 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 Crea file al comando Importa file nella tabella.
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 Runtime Inputs.
      3. Seleziona ID tabella.
   2. Clicca sul 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 + .
         3. Nel campo Value, digita "id" e clicca Invio sulla tastiera.
         4. Clicca su ACCEPT.
4. Salva il comando.

Passo 7: Prova l'esercizio

Ora che la Catena è completa, testiamo il risultato.

1. Pubblica la Catena.
2. Clicca su Execute, quindi seleziona Run With Inputs.
3. Inserisci i valori dei tuoi input di runtime.
   • ID tabella - ID della tabella "Dettaglio dipendenti CLP". 
     Consulta questo documento per trovare l'ID.
   • Nome del file - qualsiasi nome tu voglia dare al file.
     In questo esempio, chiama il file "Dettaglio dipendenti".
   • Percorso del file - Dove si trova il file CSV.
     Per questo esempio, usa: 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.

   La catena dovrebbe aver preso il file, creato un file Workiva e importato nella tua tabella. Puoi verificare che i dati siano stati caricati nella tua tabella navigando nella Tabella di Wdata ed esaminando il dataset nel pannello di destra.

Per saperne di più sulla gestione degli insiemi di dati nelle tabelle Wdata utilizzando le catene, consulta il percorso successivo: Cancellare i dati da una tabella!