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:
- I Chain Builder går du til fanen Templates .
- Velg Workiva Chains fra menyen øverst.
- Søk etter Load Data to Wdata | Primary Chain øverst til høyre, og åpne malen.
-
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
| Type | Navn | Formål |
| Variabel for arbeidsområde | wsv-WdataLoadWarningThreshold |
Denne variabelen fungerer som en myk grense for størrelsen på datasettfilen. Alle datasett over den valgte terskelen vil utløse en advarsel. Fordi behandlingstiden vokser med filstørrelsen, kan mindre datasett behandles betydelig raskere. Den anbefalte filstørrelsen gir en god advarsel om at datasettet ditt kan nærme seg filstørrelsesgrensen Wdata. Når en advarsel utløses, kan du vurdere å omarbeide filen eller utforske andre alternativer for å ta hensyn til den større filen. Anbefalt filstørrelse: 150MB-200MB |
| Dynamisk kjedevariabel | dcv-kjede Resultat | Fanger opp status for kjeden på ulike stadier. Dette er påkrevd og bør ikke endres. |
Innganger ved kjøretid
| Inndata ved kjøretid | Formål | Felttype | Påkrevd |
| Tabell-ID |
Angi Wdata Table ID som datasettet skal lastes opp til. Denne ID-en brukes også til å finne ut om det finnes dupliserte datasett i tabellen. Vi anbefaler at du bruker arbeidsområdevariabler til å lagre tabell-ID-en, slik at malen kan brukes på tvers av flere prosesser. |
Tekst | Ja |
| Filnavn |
Navnet på datasettet som skal importeres til Wdata-tabellen. Filnavnet forteller kjeden hvilke data som skal erstattes. Kravene til filnavn varierer avhengig av hvilken kjede som er valgt:
Merk: Filnavnet må inneholde filtypen .csv eller .tsv. For eksempel "Filnavn_eksempel.csv" |
Tekst | Ja |
| Datafil |
Datafilen som skal importeres til tabellen. Endelsen må være .csv eller .tsv. Merk: Datafilen kan bruke hvilken som helst av de støttede Wdata-tabellavgrenserne. |
Fil | Ja |
| Belastningsmetode |
Bestemmer om filen skal erstatte et eksisterende datasett eller legges til som et nytt. Alternativer:
|
Nedtrekksmeny |
Ja |
| Tilbakeføring |
Hvis det oppstår en feil, tilbakestilles eventuelle endringer, og det opprinnelige datasettet importeres på nytt. Satt til True som standard. Gjelder bare for innlastingsmetoden Erstatt datasett. |
Boolsk (sant/usant) |
Nei |
Feilsøking
Slik ser du historikken for kjedekjøringer, inkludert feil:
- Gå til fanen Monitor i Chain Builder.
-
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:
- Legg til følgende kjøretidsinnganger på for hver av de tre kjedene distribuert fra denne malen:
- Tag-nøkkel (tekstfelt)
- Tag-Value (tekstfelt)
- Rediger Primary Chain for å sende kjøretidsinndataene til hver "Run Chain"-hendelse:
- 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.