Centro assistenza di Workiva

Il modello Load Data to Wdata porta i dati in una tabella Wdata sostituendo un dataset esistente o aggiungendone uno nuovo. Questo modello viene utilizzato più spesso come parte di una catena esistente, ma può essere aggiunto a qualsiasi flusso di lavoro che richieda il caricamento di un set di dati in una tabella.

Requisiti

• La tabella Wdata di destinazione deve essere creata prima di eseguire questa catena.
• Questo modello è composto da tre catene. Ogni catena deve essere pubblicata separatamente nel tuo spazio di lavoro.
• Il nome del file deve includere un'estensione .csv o .tsv. Ad esempio: "Nome_File_Esempio.csv".
• La dimensione massima consigliata per un set di dati è di 300 mb. Per saperne di più sulle dimensioni consigliate per i file.

Trova il modello

Il modello Load Data to WData si trova nella sezione Catene di Workiva della schermata Templates.

Ecco come trovarlo:

1. In Chain Builder, vai alla scheda Templates dynamic_feed .
2. Seleziona Catene di Workiva dal menu in alto.
3. Cerca Load Data to Wdata | Primary Chain in alto a destra e apri il modello.

4. Dopo aver individuato il modello, clicca su New Chain per distribuirlo nel tuo spazio di lavoro. 

   Nota: Una volta configurata, ogni catena di questo modello deve essere pubblicata nell'area di lavoro.

Configura il template

Questo modello è composto da tre catene: la Catena Primaria, una Catena Sostituisci Dataset e una Catena Aggiungi Nuovo Dataset. Quando la Catena Primaria viene distribuita nell'area di lavoro, le due catene figlie (Aggiungi/Sostituisci) vengono distribuite automaticamente con essa.

Ecco un approfondimento su ogni catena:

• Catena primaria: Questa catena determina se all'interno della tua tabella esiste un set di dati con lo stesso nome del set di dati caricato dalla catena.  Se viene trovato un set di dati corrispondente, la catena cattura le informazioni sul set di dati corrispondente e, in base all'input di runtime "Load Method" che hai configurato per la catena padre, reindirizza i dati a una delle due catene figlie.

• Catena di sostituzione del set di dati: Questa catena rimuove il dataset corrispondente dalla tabella e lo sostituisce con uno nuovo. Se si verifica un errore durante l'esecuzione e viene selezionata l'opzione di rollback, la catena eliminerà automaticamente il nuovo set di dati e tornerà al set di dati che doveva essere sostituito.  

• Catena Add New Dataset: Questa catena crea un nuovo set di dati e lo importa nella tua tabella. Il nuovo set di dati deve avere un nome di file univoco che non sia attualmente utilizzato da altri set di dati nella tabella.

Quando si aggiunge questo set di catene a una catena esistente, gli input di runtime della Catena Primaria devono essere configurati nel nodo "Catena di esecuzione".  Le catene secondarie non richiedono alcuna modifica o configurazione.  

Le tue impostazioni dovrebbero assomigliare a queste:

Variabili

Input di runtime

Risoluzione dei problemi

Per visualizzare la cronologia dell'esecuzione della catena, compresi gli errori:

1. Vai alla scheda Monitor di Chain Builder.
   

2. Passa il mouse sul punto interrogativo per visualizzare lo stato dell'esecuzione della catena.
   
   

Se la catena ha generato un errore o non è riuscita ad aggiornare i dati corretti, esegui i seguenti controlli:

• Verifica che tutte e tre le catene siano state pubblicate nel tuo spazio di lavoro. Ogni catena deve essere pubblicata separatamente.
• Assicurati che il set di dati utilizzi un delimitatore supportato e che il nome del file includa un'estensione .csv o .tsv ("Nome_File_Esempio.csv").
• Quando usi il metodo di caricamento Replace Dataset, controlla che il nome del file corrisponda al nome del file esistente nella tua tabella Wdata. Se non corrisponde, la catena aggiungerà semplicemente un nuovo file alla tabella senza sostituire quello vecchio.
• Al contrario, se utilizzi il metodo di caricamento Add New Dataset, controlla che il nome del file non sia utilizzato in nessun altro punto della tabella Wdata. La catena fallirà se viene utilizzato un nome di file sovrapposto.
• Assicurati che la sovvenzione OAuth2 associata alla connessione Workiva abbia un accesso appropriato.
• Quando inserisci l'ID della tabella, assicurati che l'ID sia stato inserito per intero e che non ci siano spazi vuoti iniziali o finali.
• Verifica la presenza di variabili runtime timestamp. Questi non dovrebbero essere utilizzati nei nomi dei file, in quanto creano un nome di file unico per ogni set di dati, il che significa che la catena non sarà in grado di identificare i set di dati corrispondenti nella tua tabella.

Mappature delle colonne e altre modifiche alla catena

Se hai problemi con le intestazioni delle colonne durante l'importazione dei dati, puoi utilizzare data prep o altri comandi. 

Opzionale: Taggare i set di dati importati

Il tag è supportato quando si importano i set di dati, ma si consiglia di distribuire un set aggiuntivo di catene dal modello prima di apportare qualsiasi modifica all'originale. Una volta modificata, la catena sarà probabilmente difficile da riutilizzare per altre tabelle, a meno che i set di dati in esse contenuti non utilizzino gli stessi tag.  

Per aggiungere i tag a una catena:

1. Aggiungi i seguenti input di runtime a ciascuna delle tre catene distribuite da questo modello:
   • Tag-Key (campo di testo)
   • Tag-Valore (campo di testo)
     
2. Modifica la catena primaria per passare gli input di runtime a ogni evento "Run Chain":
3. Sia nella catena Replace Dataset Chain che nella catena Add New Dataset Chain, modifica il nodo di comando "Import New Dataset" per accettare gli input di runtime del tag.

Una volta completata l'operazione, i set di dati importati saranno etichettati con la chiave tag e il valore tag forniti.

Risorse aggiuntive

• Connettore Workiva
• Connettore Utilità dei file
• Connettore JSON
• Connettore Trasformazione tabellare
• Esegui una catena all'interno di un'altra catena ("Esegui eventi a catena")
• Sovvenzioni OAuth2
• Limiti delle caratteristiche e delle API di Wdata