Innledning
Malen Data Dictionary Chain gjør det mulig for brukere å registrere og eksportere detaljer på høyt nivå om spesifikke tabeller i arbeidsområdet til et regneark. Brukerne kan angi et nøkkelord for å finne tabeller, definere navnet på eksportregnearket og opprette en tabell i arbeidsområdet for å lagre skjemaet for hver tabell.
For mer informasjon, se dokumentasjonen på Load Data to Wdata Process for en omfattende oversikt. Det anbefales at du går gjennom denne dokumentasjonen før du bruker Data Dictionary-malen .
Forutsetninger
Denne malen forutsetter at følgende objekter allerede er satt opp 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 praksis for å administrere OAuth Grant.
- Følgende Connectors må være aktivert og konfigurert i arbeidsområdet ditt:
Merk: Noen variabelverdier kan inneholde sensitiv informasjon, for eksempel brukernavn og passord. Vi anbefaler at du bruker alternativet "Krypter" for informasjonssensitive variabler og angir passende tillatelser for regnearket ditt.
- Konfigurer variabler
- For at Load Data to Wdata-underkjeden i malen skal fungere som forventet, må det opprettes en workspace -variabel med tittelen wsv-WdataLoadWarningThreshold.
Merk: Det er best å sette standardverdien for denne variabelen til 50 (som tilsvarer 50 MB), men den kan justeres om nødvendig.
-
- I tillegg må fire andre arbeidsområdevariabler opprettes før du kan bruke Data Dictionary-kjeden.
Nedenfor følger en oversikt over hver variabel som må settes opp og fylles ut:
Bygg kjeden din
Malen Data Dictionary | ALL | Primary Chain ligger i Workiva Chains-delen av maler-skjermbildet.
Slik finner du den:
- I Chain Builder går du til Templates fanen.
- Velg Workiva Chains fra menyen øverst
- Søk etter Data Dictionary | ALL | Primary Chain Template øverst til høyre, og åpne malen
Når Data Dictionary | ALL | Primary chain distribueres til et arbeidsområde, distribueres det automatisk seks ekstra underkjeder.
Brukerne må sørge for at alle de sju kjedene er distribuert og publisert i samme arbeidsområde:
- Data Dictionary | ALL | Primary
- Data Dictionary | Opprett dokument og underseksjoner | Opprettelse av regneark
- Data Dictionary | Opprett dokument og underseksjoner | Opprettelse av ark
- Data Dictionary | 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
Når du har funnet malen din, konfigurerer du for arbeidsområdet ditt ved hjelp av variablene som ble opprettet i avsnittet ovenfor.
Merk: For detaljerte instruksjoner om hvordan du oppretter en kjede fra en mal, se artikkelen Opprett og administrer kjeder.
Runtime-innganger
Når du kjører denne primære kjeden (Data Dictionary | ALL | Primary), må følgende Run Time Inputs fylles ut eller sendes gjennom en anropende kjede:
| Runtime Input | Beskrivelse | Felttype | Er det nødvendig? |
|---|---|---|---|
| Regnearknavn | Angir navnet på regnearket der tabellskjemaet skal skrives. | Tekst | Ja |
| Søkeverdi | Denne inngangen brukes til å finne tabeller som inneholder det angitte nøkkelordet. | Tekst | Ja |
| Wdata Tabellnavn | Angir navnet på dataordbokstabellen som opprettes ved første gangs kjøring av malen. | Tekst | Ja |
Wdata-tabell
For å kunne bruke denne kjeden må det finnes en Data Dictionary Wdata-tabell i arbeidsområdet. Kjeden oppretter automatisk denne tabellen ved hjelp av navnekonvensjonen "Data Dictionary Table", med mindre brukeren angir et annet tabellnavn.
Følgende tabellskjema vil bli brukt til å bygge opp dataordbokstabellen:
| Kolonnenavn | Beskrivelse av kolonnen | Kolonne-ID | Kolonnetype |
|---|---|---|---|
| Tabell_navn | I/A | tabell_navn | 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 kolonneoverskriftene ikke stemmer overens når de importerer dataene sine til en Wdata-tabell, kan de bruke data prep eller andre kommandoer for å rette opp dette. Hvis en bruker legger til tilpassede justeringer i denne malen, anbefales det imidlertid at de tar en kopi før de gjør det. Alle endringer i malen vil hindre gjenbruk av den. Dette gjelder også hvis du bruker en -taggkonfigurasjon på malen.
Feilsøking
Følgende trinn kan brukes til å feilsøke problemer med kjedemalen:
Feil i kjedeutførelsen
- Kontroller at alle kjedene er publisert.
- Sørg for at OAuth2-legitimasjonen (
wsv-Client IDogwsv-Client Secret) er gyldig og oppdatert. - Kontroller arbeidsområdetillatelsene for brukeren som kjører kjeden.
Feil ved dataimport
- Kontroller at kolonneoverskriftene i kildefilen stemmer overens med skjemaet for Wdata-tabellen.
- For operasjonen Erstatt datasett må du sørge for at filnavnene samsvarer med eksisterende datasett i tabellen.
- For Add New Dataset-operasjoner må du sørge for at filnavnene er unike i tabellen.
Opprettelse av dupliserte tabeller eller regneark
- Bruk konsistente navn for
Wdata Table NameogSpreadsheetNamepå tvers av kjøringer.
Skjerm
- Brukerne kan diagnostisere årsaken til en feil ved å navigere til skjermen.
- Variabelen DCV_Chain Result viser kjedens status basert på det endelige resultatet. Hvis det oppstår en feil, vil årsaken til feilen bli lagt til i utgangsteksten for kjeden på skjermen.
Brukerne kan også bruke skjermbildet for å finne ut om filen ble importert
Beste praksis
-
Unngå å tilpasse den opprinnelige malen:
Lag en kopi hvis det er behov for justeringer. Endringer i malen kan hindre gjenbruk. -
Tagging for Enhanced Context:
Legg til kjøretidsinnganger (Tag-KeyogTag-Value) for å tagge datasett, om nødvendig. Oppdater kjedenodene slik at de sender disse inndataene. -
Filstørrelsesadministrasjon:
Overvåk størrelsen på datasettet ved hjelp av variabelenwsv-WdataLoadWarningThreshold. Vurder å dele opp store datasett hvis det utløses advarsler.