Innledning
Malen Data Dictionary Chain lar brukere registrere og eksportere detaljer på høyt nivå om bestemte tabeller i arbeidsområdet til et regneark. Brukere kan angi et nøkkelord for å finne tabeller, definere navnet på det eksporterte regnearket og opprette en tabell i arbeidsområdet for å lagre skjemaet for hver tabell.
For mer informasjon, se dokumentasjonen for Last inn data til Wdata-prosessen for en omfattende oversikt. Det anbefaleså gjennomgå denne dokumentasjonen før du bruker Data Dictionary-malen.
Forutsetninger
Denne malen forutsetter at følgende objekter allerede er konfigurert i Workiva-applikasjonen din:
- API-tilskudd
- For å kunne utnytte Workiva API-er, må en bruker opprette en OAuth API Grant i arbeidsområdet sitt. Se denne artikkelen for ledende praksiser for administrasjon av OAuth-tildeling.
- Følgende koblinger må være aktivert og konfigurert i arbeidsområdet ditt:
Merk: Enkelte variabelverdier kan inneholde sensitiv informasjon, som brukernavn og passord. Vi anbefaler å bruke alternativet «Krypter» for informasjonssensitive variabler og å angi riktige tillatelser for regnearket ditt.
- Konfigurer variabler
- For at underkjeden Last inn data til Wdata i malen skal fungere som forventet, må det opprettes en variabel i arbeidsområde med tittelen wsv-WdataLoadWarningThreshold.
Merk: Det er best å sette standardverdien for denne variabelen til 50 (som representerer 50 MB), men dette kan justeres om nødvendig.
-
- I tillegg må fire andre arbeidsområdevariabler opprettes før dataordlistekjeden brukes.
Nedenfor er en oversikt over hver variabel som må settes opp og fylles ut:
Bygg din kjede
Malen Dataordbok | ALLE | Primær -kjede finnes i Workiva-kjeder-delen av malskjermen.
Slik finner du det:
- I Kjedebyggergår du til fanen Maler .
- Velg Workiva-kjeder fra menyen øverst
- Søk etter Dataordbok | ALLE | PrimærKjedemal øverst til høyre og åpne malen
Når Data Dictionary | ALL | Primærkjeden distribueres i et arbeidsområde, vil den automatisk distribuere seks ekstra underkjeder.
Brukere må sørge for at alle sju kjedene er distribuert og publisert i samme arbeidsområde:
- Dataordbok | ALLE | Primær
- Dataordbok | Opprett dokument og underseksjoner | Oppretting av regneark
- Dataordbok | Opprett dokument og underseksjoner | Oppretting av ark
- Dataordbok | Opprett tabell
- Last inn data til Wdata | Primærkjede
- Last inn data til Wdata | Erstatt datasett
- Last inn data til Wdata | Legg til nytt datasett
Etter at du har funnet malen din, konfigurerer den for arbeidsområdet ditt ved hjelp av variablene som er opprettet i avsnittet ovenfor.
Merk: For detaljerte instruksjoner om hvordan du oppretter en kjede fra en mal, se artikkelen Opprett og administrer kjeder
Kjøretidsinnganger
Når denne primærkjeden kjøres (Data Dictionary | ALL | Primary), må følgende kjøretidsinndata fylles ut eller sendes gjennom en kallende kjede:
| Kjøretidsinndata | Beskrivelse | Felttype | Påkrevd? |
|---|---|---|---|
| Regnearknavn | Angir navnet på regnearket der tabellskjemaet skal skrives. | Tekst | Ja |
| Søkeverdi | Denne inndataen brukes til å finne tabeller som inneholder det angitte nøkkelordet. | Tekst | Ja |
| Wdata-tabellnavn | Angir navnet på dataordlistetabellen som ble opprettet ved første malkjøring. | Tekst | Ja |
Wdata-tabell
For å bruke denne kjeden må det finnes en Data Dictionary Wdata-tabell i arbeidsområdet. Kjeden vil automatisk opprette denne tabellen ved å bruke navnekonvensjonen «Data Dictionary Table», med mindre en bruker angir et annet tabellnavn.
Følgende tabellskjema vil bli brukt til å bygge dataordlistetabellen:
| Kolonnenavn | Kolonnebeskrivelse | Kolonne-ID | Kolonnetype |
|---|---|---|---|
| Tabellnavn | I/A | tabellnavn | tekst |
| Alias | I/A | alias | tekst |
| Modus | I/A | modus | tekst |
| Navn | I/A | navn | tekst |
| Type | I/A | type | tekst |
Ansvarsfraskrivelse for tilpassede justeringer: Hvis brukere opplever problemer med at kolonneoverskrifter ikke samsvarer når de importerer dataene sine til en Wdata-tabell, kan de bruke dataforberedelse eller andre kommandoer for å korrigere dette. Hvis en bruker imidlertid legger til tilpassede justeringer i denne malen, anbefales det at de lager en kopi før de gjør det. Eventuelle endringer i malen vil hindre dens gjenbrukbarhet. Dette gjelder også hvis du bruker en tagkonfigurasjon på malen
.Feilsøking
Følgende trinn kan brukes til å feilsøke problemer med kjedemalen:
Kjedekjøringsfeil
- Bekreft at alle kjedene er publisert.
- Sørg for at OAuth2-legitimasjonen (
wsv-Client IDogwsv-Client Secret) er gyldig og oppdatert. - Sjekk arbeidsområdetillatelsene for brukeren som kjører kjeden.
Feil ved dataimport
- Bekreft at kolonneoverskriftene i kildefilen samsvarer med skjemaet til Wdata-tabellen.
- For Erstatt datasett-operasjoner, sørg for at filnavnene samsvarer med eksisterende datasett i tabellen.
- For operasjoner med «Legg til nytt datasett» må du sørge for at filnavnene er unike i tabellen.
Oppretting av duplikattabell eller regneark
- Bruk konsistente navn for
Wdata-tabellnavnogregnearknavnpå tvers av kjøringer.
Skjerm
- Brukere kan diagnostisere årsaken til en feil ved å navigere til skjermen.
- DCV_Chain Result-variabelen registrerer statusen til kjeden basert på det endelige resultatet. Hvis det oppstår en feil, vil årsaken til feilen gjelde for utdatateksten til kjeden på skjermen.
Brukere kan også bruke skjermen til å avgjøre om filen ble importert.
Beste praksis
-
Unngå å tilpasse den opprinnelige malen:
Opprett en kopi hvis det er behov for justeringer. Endringer i malen kan hindre gjenbrukbarhet. -
Tagging for forbedret kontekst:
Legg til kjøretidsinndata (Tag-KeyogTag-Value) for å tagge datasett, om nødvendig. Oppdater kjedenoder for å sende disse inndataene. -
Filstørrelseshåndtering:
Overvåk datasettstørrelsen ved hjelp av variabelenwsv-WdataLoadWarningThreshold. Vurder å dele store datasett hvis advarsler utløses.