Denne veiledningen gir trinnvise instruksjoner for implementering av malen Kjør spørring og last ned resultater med kontrollark . Denne malen fungerer som et alternativ til kommandoen Run Query , som tidligere krevde at brukere manuelt anga parametere i kjeder før distribusjon og utførelse.
Ved bruk av et kontrollark kan brukere legge til flere spørrings-ID-er og definere parametere, for eksempel Valgliste eller Flervalg , dynamisk. Denne malen integreres vanligvis i eksisterende kjeder, men kan også brukes i enhver arbeidsflyt som krever spørreresultater i CSV-format .
Forutsetninger
Følgende koblinger må være aktivert og konfigurert i arbeidsområdet ditt.
- Konfigurer Workiva-koblingen
- Konfigurer JSON-koblingen
- Konfigurer styrekontakten
- Konfigurer HTTP-forespørselskoblingen
- Konfigurer tabelltransformasjonskoblingen
Følgende arbeidsområdevariabler må opprettes i arbeidsområdet ditt:
- wsv_API Basis-URL – IAM
- wsv_Klient-ID
- wsv_Klienthemmelighet
- wsv_API Basis-URL – Wdata
Finn malen
Malen Kjør spørring og last ned resultater med kontrollark finnes i Workiva-kjeder-delen av skjermbildet Maler .
Slik finner du det:
- I Chain Builder går du til fanen Maler
- Velg Workiva-kjeder fra menyen øverst.
- Søk etter 0.0 Utfør en spørring | Orkestrering på toppnivå øverst til høyre og åpne malen.
-
Etter at du har funnet malen, klikker du på Ny kjede for å distribuere den til arbeidsområdet ditt.
Merk: Når den er konfigurert, må hver kjede i denne malen publiseres til arbeidsområdet.
Variabler
| Variabel type | Variabelnavn | Beskrivelse |
|---|---|---|
| Arbeidsområdevariabel | wsv_API Basis-URL – IAM |
Skriv inn basis-URL-en for API-et basert på regionen din:
|
| Arbeidsområdevariabel | wsv_Klient-ID |
Skriv inn klient-ID-en du mottar når du konfigurerer et API-tildelingsskjema. Se her for flere instruksjoner for Workiva API. |
| Arbeidsområdevariabel | wsv_Klienthemmelighet |
Du kan se API-tildelingshemmeligheten din ved å gå til Sikkerhet-fanen i brukerprofilen din, og deretter klikke på alternativet Generer på nytt i rullegardinmenyen Handlinger ved siden av tildelingen. Se her for flere instruksjoner for Workiva API |
| Arbeidsområdevariabel | wsv_API Basis-URL – Wdata |
Skriv inn basis-URL-en for API-et basert på regionen din:
|
Kjøretidsinnganger
| Kjøretidsinndata | Hensikt | Felttype | Påkrevd |
|---|---|---|---|
| Regneark-ID | Det er her kontrollregnearket er plassert. | Tekst | Ja |
| Ark-ID | Det er her kontrollskjemaet befinner seg. | Tekst | Ja |
Konfigurer malen
Denne malen består av to kjeder, 0.0 Utfør en spørring | Orkestrering på toppnivå og 0.1 Utfør en spørring | Last ned resultater . Når primærkjeden er distribuert i arbeidsområdet ditt, distribueres kjedekjeden automatisk sammen med den.
- Toppnivåorkestrering : Basert på informasjonen fra kontrollarket, avgjør denne kjeden om en spørring bruker én parametertype (enten Valgliste eller Flervalg ) eller flere parametertyper (både Valgliste og Flervalg ).
- Utfør en spørring | Last ned resultater: Denne kjeden kjører en spørring ved hjelp av de angitte parameterne og henter de tilsvarende dataene. Når spørringen er utført, lastes resultatene ned i CSV-format for videre analyse eller bruk.
Når kontrollarket er konfigurert og kjedemalen er distribuert i arbeidsområdet ditt, trenger du bare regneark-ID og ark-ID for kontrollarket.
Disse verdiene må legges til som kjøretidsinndata for toppnivåorkestreringskjeden .
Kontrollarkkonfigurasjon etter parametertype
Måten du konfigurerer kontrollarket på, avhenger av parametertypene som er definert i Wdata-spørringen din. Hvis en spørring inkluderer flere parametertyper (for eksempel både Valgliste og Flervalg ), må hver parameter defineres på en separat rad ved å bruke samme spørrings-ID . Hvis en spørring bruker bare én parametertype , krever kontrollarket én enkelt rad for den spørringen.
Eksemplene nedenfor illustrerer begge scenariene.
Eksempel: Spørring med flere parametertyper
For en spørring som krever både parameterne Valgliste og Flervalg skal kontrollarket inneholde separate rader for hver parameter , som alle bruker samme spørrings-ID .
Merk: Kolonnen Nøkkel refererer til Parameternavn som er definert i Wdata-spørringen.
Eksempelkonfigurasjon:
| Søke-ID | Type | Nøkkel | Verdier |
|---|---|---|---|
| Wdata-spørrings-ID | Valglisteparametere | År | Angi én standardverdi (f.eks. 2023 ). |
| Wdata-spørrings-ID | Flervalgsparametere | Kontotype | Skriv inn flere akseptable verdier, kommaseparerte (f.eks. Eiendel, Utgift, Egenkapital, Inntekt ). |
Eksempel: Spørring med én parametertype
For en spørring som bare bruker én parametertype , skal kontrollarket inneholde én enkelt rad for den spørrings-ID-en.
Hvis for eksempel spørringen bare bruker en Pick List parameter:
| Søke-ID | Type | Nøkkel | Verdier |
|---|---|---|---|
| Wdata-spørrings-ID | Valglisteparametere | År | Angi én standardverdi (f.eks. januar ). |
Sørg for at kontrollarket er konfigurert nøyaktig, da feil oppsett kan føre til problemer nedstrøms.
Laster inn data i en tabell
Du kan automatisere prosessen med å laste inn resultatet direkte i en tabell. For å laste inn utdataene i en tabell, bør du vurdere å bruke malen " Last inn data til Wdata " . Dette kan utløses som en del av prosessen din ved å legge til en Run Chain-hendelse ved HTTP-koblingen som laster ned resultater.
Feilsøking
Slik viser du kjedekjøringshistorikken din, inkludert feil:
- Gå til fanen Overvåk i Chain Builder.
-
Hold musepekeren over spørsmålstegnet for å se statusen til kjedekjøringen.
Hvis kjeden din utløste en feil eller mislyktes i å laste ned et spørreresultat, utfør følgende kontroller:
- Bekreft at begge kjedene er publisert i arbeidsområdet ditt. Hver kjede må publiseres separat.
- Sørg for at spørringen i Wdata er oppdatert til den nyeste versjonen.
- Når du skriver inn Spørre-ID , Type, Nøkler og Verdi i kontrollarket , må du sørge for at hele ID-en er skrevet inn, og at det ikke er noen innledende eller etterfølgende mellomrom. Bekreft også at nøklene og verdiene samsvarer riktig med parameterne som brukes i Wdata.
- Sørg for at OAuth2-rettigheter som er knyttet til Workiva-tilkoblingen har riktig tilgang.
- Sørg for at alle parametere som brukes i en spørring er inkludert i kontrollarket.
Flere ressurser
- Workiva-kontakt
- Filverktøy-kobling
- JSON-kobling
- Tabelltransformasjonskobling
- Kjør en kjede innenfor en annen kjede ("Kjør kjedehendelser")
- OAuth2-tilskudd
- Wdata-funksjoner og API-grenser