Workiva kundestøttesenter

Malen Load Data to Wdata henter data til en Wdata-tabell ved enten å erstatte et eksisterende datasett eller legge til et nytt. Denne malen brukes oftest som en del av en eksisterende kjede, men den kan legges til i alle arbeidsflyter som krever at et datasett lastes opp til en tabell.

Krav

• Måltabellen Wdata må være opprettet før denne kjeden kjøres.
• Denne malen består av tre kjeder. Hver kjede må publiseres separat til arbeidsområdet ditt.
• Filnavnet må inneholde filtypen .csv eller .tsv. For eksempel "Filnavn_eksempel.csv".
• Den maksimale anbefalte filstørrelsen for et datasett er 300 MB. Finn ut mer om anbefalinger for filstørrelse.

Finn malen

Malen Load Data to WData (Last inn data til WData) finner du i Workiva Chains-delen av Templates.

Slik finner du den:

1. I Chain Builder går du til fanen Templates dynamic_feed .
2. Velg Workiva Chains fra menyen øverst.
3. Søk etter Load Data to Wdata | Primary Chain øverst til høyre, og åpne malen.

4. Når du har funnet malen, klikker du på New Chain for å distribuere den til arbeidsområdet ditt. 

   Merk: Når hver kjede i denne malen er konfigurert, må den publiseres i arbeidsområdet.

Konfigurer malen

Denne malen består av tre kjeder: Primærkjeden, en Erstatt datasett-kjede og en Legg til nytt datasett-kjede. Når den primære kjeden distribueres i arbeidsområdet, distribueres de to underordnede kjedene (Add/Replace) automatisk sammen med den.

Her er en nærmere titt på hver kjede:

• Primærkjede: Denne kjeden avgjør om det finnes et datasett i tabellen din som har samme navn som datasettet som lastes inn av kjeden. Hvis det finnes et matchende datasett, innhenter kjeden informasjon om det matchende datasettet og omdirigerer dataene til én av to underordnede kjeder, basert på "Load Method"-inndataene du har konfigurert for den overordnede kjeden.

• Erstatt datasett-kjeden: Denne kjeden fjerner det matchede datasettet fra tabellen og erstatter det med et nytt. Hvis det oppstår en feil under kjøringen og alternativet rollback er valgt, vil kjeden automatisk slette det nye datasettet og gå tilbake til det datasettet som skulle erstattes.  

• Legg til ny datasettkjede: Denne kjeden oppretter et nytt datasett og importerer det til tabellen din. Det nye datasettet må ha et unikt filnavn som ikke brukes av andre datasett i tabellen.

Når du legger til dette settet med kjeder i en eksisterende kjede, må kjøretidsinngangene for primærkjeden konfigureres i noden "Kjør kjede". Barnekjedene krever ingen endringer eller konfigurasjon.  

Innstillingene dine bør se omtrent slik ut:

Variabler

Innganger ved kjøretid

Feilsøking

Slik ser du historikken for kjedekjøringer, inkludert feil:

1. Gå til fanen Monitor i Chain Builder.
   

2. Hold musepekeren over spørsmålstegnet for å se status for kjedekjøringen.
   
   

Hvis kjeden din utløste en feil eller ikke klarte å oppdatere de riktige dataene, må du utføre følgende kontroller:

• Kontroller at alle tre kjedene er publisert i arbeidsområdet ditt. Hver kjede må publiseres separat.
• Sørg for at datasettet ditt bruker et støttet skilletegn, og at filnavnet inneholder filtypen .csv eller .tsv ("File_Name_Example.csv").
• Når du bruker innlastingsmetoden Erstatt datasett, må du kontrollere at filnavnet stemmer overens med det eksisterende filnavnet i Wdata-tabellen. Hvis den ikke stemmer overens, vil kjeden ganske enkelt legge til en ny fil i tabellen uten å erstatte den gamle.
• Når du derimot bruker innlastingsmetoden Add New Dataset, må du kontrollere at filnavnet ikke brukes andre steder i Wdata-tabellen. Kjeden vil mislykkes hvis et overlappende filnavn brukes.
• Sørg for at OAuth2 grant som er knyttet til Workiva-tilkoblingen, har riktig tilgang.
• Når du skriver inn tabell-ID-en, må du forsikre deg om at hele ID-en er skrevet inn, og at det ikke er noen tomme mellomrom foran eller bak.
• Se etter tidsstempelvariabler for kjøretid. Disse bør ikke brukes i filnavn, da det opprettes et unikt filnavn for hvert datasett - noe som betyr at kjeden ikke vil kunne identifisere matchende datasett i tabellen din.

Kolonnemappinger og andre kjedemodifikasjoner

Hvis du opplever problemer med kolonneoverskriftene når du importerer data, kan du bruke data prep eller andre kommandoer. 

Valgfritt: Merking av importerte datasett

Tagging av støttes ved import av datasett, men vi anbefaler at du distribuerer et ekstra sett med kjeder fra malen før du gjør endringer i originalen. Når kjeden er endret, vil den sannsynligvis være vanskelig å gjenbruke i andre tabeller, med mindre datasettene i disse tabellene bruker de samme taggene.  

Slik legger du til merking i en kjede:

1. Legg til følgende kjøretidsinnganger på for hver av de tre kjedene distribuert fra denne malen:
   • Tag-nøkkel (tekstfelt)
   • Tag-Value (tekstfelt)
     
2. Rediger Primary Chain for å sende kjøretidsinndataene til hver "Run Chain"-hendelse:
3. I både Replace Dataset Chain og Add New Dataset Chain kan du redigere kommandonoden "Import New Dataset" slik at den godtar taggens kjøretidsinndata.

Når du er ferdig, blir de importerte datasettene tagget med den angitte tag-nøkkelen og tag-verdien.

Flere ressurser

• Workiva-kontakt
• File Utilities-kontakt
• JSON-kontakt
• Kobling for tabelltransformasjon
• Kjør en kjede innenfor en annen kjede ("Run Chain events")
• OAuth2-bevilgninger
• Wdata-funksjon og API-grenser