Workiva supportcenter

Mallen Load Data to Wdata för in data i en Wdata-tabell genom att antingen ersätta ett befintligt dataset eller lägga till ett nytt. Den här mallen används oftast som en del av en befintlig kedja, men den kan läggas till i alla arbetsflöden som kräver att ett dataset laddas upp till en tabell.

Krav

• Måltabellen Wdata måste skapas innan den här kedjan körs.
• Denna mall består av tre kedjor. Varje kedja måste publiceras separat publicerad till din arbetsyta.
• Filnamnet måste innehålla en .csv- eller .tsv-förlängning. Till exempel: "Filnamn_Exempel.csv".
• Den högsta rekommenderade filstorleken för ett dataset är 300 MB. Läs mer om rekommendationer för filstorlek.

Hitta mallen

Mallen Load Data to WData finns i avsnittet Workiva Chains på skärmen Templates.

Så här hittar du den:

1. I Chain Builder går du till fliken Templates dynamic_feed .
2. Välj Workiva Chains från menyn högst upp.
3. Sök efter Load Data to Wdata | Primary Chain längst upp till höger och öppna mallen.

4. När du har hittat mallen klickar du på New Chain för att distribuera den till din arbetsyta. 

   Obs: När varje kedja i den här mallen har konfigurerats måste den publiceras på arbetsytan.

Konfigurera mallen

Den här mallen består av tre kedjor: den primära kedjan, en kedja för ersätt dataset och en kedja för lägg till nytt dataset. När den primära kedjan distribueras på din arbetsyta distribueras de två underordnade kedjorna (Add/Replace) automatiskt tillsammans med den.

Här är en närmare titt på varje kedja:

• Primär kedja: Denna kedja avgör om det finns ett dataset i din tabell som har samma namn som det dataset som laddas av kedjan.  Om ett matchande dataset hittas samlar kedjan in information om det matchande datasetet och - baserat på exekveringen av "Load Method" som du har konfigurerat för den överordnade kedjan - omdirigerar den informationen till en av två underordnade kedjor.

• Ersätt dataset kedja: Den här kedjan tar bort det matchade datasetet från din tabell och ersätter det med ett nytt. Om ett fel inträffar under körningen och alternativet rollback är valt, kommer kedjan automatiskt att radera det nya datasetet och återgå till det dataset som skulle ersättas.  

• Lägg till ny dataset-kedja: Denna kedja skapar ett nytt dataset och importerar det till din tabell. Det nya datasetet måste ha ett unikt filnamn som inte används för närvarande av några andra dataset i tabellen.

När denna uppsättning kedjor läggs till i en befintlig kedja måste ingångarna för exekvering för den primära kedjan konfigureras i noden "Run Chain".  Barnkedjorna kräver inga ändringar eller konfigurering.  

Dina inställningar bör se ut ungefär så här:

Variabler

Ingångar vid exekvering

Felsökning

För att se din kedjekörningshistorik, inklusive fel:

1. Gå till fliken Monitor i Chain Builder.
   

2. Håll muspekaren över frågetecknet för att se status för kedjekörningen.
   
   

Om din kedja utlöste ett fel eller om det gick inte att uppdatera rätt data, utför följande kontroller:

• Kontrollera att alla tre kedjorna har publicerats på din arbetsyta. Varje kedja måste publiceras separat.
• Se till att ditt dataset använder en avgränsare som stöds och att filnamnet innehåller ett .csv- eller .tsv-tillägg ("Filnamn_Exempel.csv").
• När du använder laddningsmetoden Replace Dataset, kontrollera att filnamnet matchar det befintliga filnamnet i din Wdata-tabell. Om den inte matchar kommer kedjan helt enkelt att lägga till en ny arkivering till ditt bord utan att ersätta den gamla.
• Omvänt, när du använder laddningsmetoden Add New Dataset, kontrollera att filnamnet inte används någon annanstans i Wdata-tabellen. Kedjan går inte att använda om ett överlappande filnamn används.
• Se till att OAuth2 beviljande som är kopplat till Workiva-anslutningen har rätt åtkomst.
• När du matar in tabell-ID ska du se till att hela ID:t har matats in och att det inte finns några inledande eller avslutande blanksteg.
• Kontrollera om det finns tidsstämpelvariabler för exekvering. Dessa bör inte användas i filnamn, eftersom det skapar ett unikt filnamn för varje dataset - vilket innebär att kedjan inte kan identifiera några matchade dataset i din tabell.

Kolumnmappningar och andra kedjemodifieringar

Om du har problem med rubrikerna på kolumnerna när du importerar data kan du använda data prep eller andra kommandon. 

Valfritt: Taggning av importerade dataset

Taggning har support vid import av dataset, men vi rekommenderar att du distribuerar ytterligare en uppsättning kedjor från mallen innan du gör några ändringar i originalet. När kedjan har modifierats är det troligen svårt att återanvända den för andra tabeller om inte dataseten i dessa tabeller använder samma taggar.  

För att lägga till taggning till en kedja:

1. Lägg till följande ingångar för exekvering på för var och en av de tre kedjorna som distribueras från den här mallen:
   • Tagg-nyckel (textfält)
   • Tagg-Värde (textfält)
     
2. Redigera Primary Chain för att skicka ingångarna för exekvering till varje "Run Chain"-händelse:
3. I både Replace Dataset Chain och Add New Dataset Chain redigerar du kommandonoden "Import New Dataset" så att den godkänner taggens exekvering.

När du är klar kommer dina importerade dataset att taggas med den taggnyckel och det taggvärde som anges.

Ytterligare resurser

• Workiva-kontakt
• Anslutningsdon för filverktyg
• JSON-anslutning
• Tabulär transformationsanslutning
• Kör en kedja inom en annan kedja ("Run Chain events")
• OAuth2 Beviljande
• Wdata-funktioner och API-gränser