For å kunne bruke Connections fra kvartal til kvartal og fra år til år uten å måtte gjøre justeringer i spørringen, er det nødvendig å bruke parametere. I denne Connected Learning Path vil vi lære hvordan vi oppdaterer kjeden vår for å oppdatere en forbindelse med en parameter mellom Workiva-plattformen og en Wdata Query ved hjelp av Connection ID.
| Primært bruksområde for virksomheten | Datatilkobling mellom Workiva og Wdata |
| Primært læringsmål | Lær hvordan du oppdaterer en tilkobling med en parameter ved å angi parameterverdien ved kjedekjøring |
| Forutsetninger |
Konfigurer Workiva Connector Fullfør CLP | Oppdater tilkobling ved hjelp av ID Gi tillatelser til regnearket for den tilknyttede Workiva OAuth Grant-brukeren |
| Støttemal | CLP | Oppdater tilkoblinger med en parameter |
Trinn 1: Kopier eksisterende spørring
Først trenger vi en Query med en parameter. Vi oppretter en kopi av den eksisterende spørringen og legger til en parameter som lar oss bestemme hvilket land vi ønsker å se totalt antall ansatte for.
- Fra Wdata Home, finn Query CLP Employee Detail Query og åpne menyen
- Velg Kopi
- Oppdater navnet på spørringen til CLP Employee Detail by Country Query
- Klikk på Lagre spørring
- Fra skjermbildet for redigering av spørringer klikker du på ikonet Parameters helt til høyre i panelet
- Klikk på Add Parameters og velg Create New Parameter
- Gi parameteren et navn: Land
- Bytt plukklisten til aktivert
- I boksen Listealternativer lister du opp følgende land, hvert land på sin egen linje:
- Australia
- Brasil
- Italia
- Kenya
- USA
- Oppdater standardinnstillingen til None
- Klikk på Opprett
- For at parameteren skal kunne styre resultatene av spørringen vår, må vi koble parameteren til kolonnen i kildedataene ved hjelp av filtre. Gå til kategorien Filtre i spørringen.
- Finn kolonnen Land fra kildedataene til venstre, og klikk og dra den til filterområdet på venstre side
- Klikk på filterverdien, der det står Empty String, for å fylle ut filterverdien
- Til høyre for filterverdifeltet klikker du på parameterknappen
- Velg Land
- Klikk på Apply
-
- Du har nå en spørring med en parameter for land. Når du klikker på Kjør spørring, blir du spurt om hvilket land du vil at søkeresultatene skal vise
- Klikk på Lagre
Trinn 2: Opprett en innkommende tilkobling
For å lære hvordan du oppdaterer en tilkobling ved hjelp av en kjede, må vi først opprette en forbindelse mellom en Wdata Query og et regneark.
- Gå til CLP Employee Overview Regneark
- Legg til et nytt ark ved å klikke på
- Endre navn til CLP Employee Details by Country
- Legg til en innkommende tilkobling i arket CLP Employee Details by Country:
- Åpne Tilkoblinger-panelet til høyre ved å klikke på Tilkoblinger-ikonet
- På fanen Innkommende tilkoblinger velger du Legg til tilkobling
- Velg Wdata Query
- Velg CLP Employee Detail by Country Query (CLP-ansattdetaljer etter land)
- Sett landsparameteren til Australia
- Klikk på Connect
- Åpne Tilkoblinger-panelet til høyre ved å klikke på Tilkoblinger-ikonet
- Det finnes nå to ark med innkommende tilkoblinger i regnearket CLP Employee Overview
Trinn 3: Rediger eksisterende kjede
- Gå til Chain Builder og finn kjeden CLP | Oppdater tilkobling ved hjelp av ID
- Klikk på blyantknappen for å redigere kjeden
- Klikk på Kjedeinnstillinger øverst til høyre
- Gi kjeden et nytt navn: CLP | Oppdater tilkoblinger med en parameter
- Redd kjeden
Trinn 4: Inndata ved kjøretid
Vi bruker Runtime Inputs-kommandoen til å starte kjeden. På denne måten kan vi spesifisere hvilken tilkobling vi ønsker å oppdatere ved kjedekjøring, samt hvilken parameter vi ønsker å oppdatere verdien for.
- Rediger Runtime Inputs Chain Event ved å dobbeltklikke på kommandoen
- Klikk to ganger på knappen Add Input og legg til følgende innganger:
- Inngang 1:
- Type: TextField
- Vis navn: Parameternavn
- Påkrevd Ikke krysset av
- Inngang 2:
- Type: TextField
- Vis navn: Parameterverdi
- Påkrevd Ikke krysset av
- Inngang 1:
- Lagre kommandoen
Trinn 5: Oppdater tilkoblingen
For å ta hensyn til den nye parameteren må vi oppdatere Refresh Connections-kommandoen slik at den tar hensyn til parameteren og verdien som skal overføres til spørringen.
- Rediger Refresh Connection ved å dobbeltklikke på Command
- Tilkoblings-ID: Fortsett å bruke variabelen Connection ID fra Runtime Inputs
- Legg til en parameter
- Siden parameterne våre lagres i kilden (i spørringen), vil vi fylle ut parameterne i kilden. Klikk på knappen + ved siden av Kildeparametere
- Parameternavn: Bruk variabelen Parameter Name fra Runtime Inputs - dette gjør det mulig for oss å skyve parameternavnverdien som er angitt i Chain run time, til Refresh Connections Command
- Klikk på feltet Parameternavn
- Utvid rullegardinmenyen Utløser i venstre panel
- Utvid rullegardinmenyen Runtime Inputs
- Velg variabelen Parameternavn
- Parameterverdi: Bruk variabelen Parameter Value fra Runtime Inputs - dette gjør det mulig for oss å skyve parameterverdien som er angitt i Chain Run Time, til Refresh Connections-kommandoen
- Klikk på feltet Parameternavn
- Utvid rullegardinmenyen Utløser i venstre panel
- Utvid rullegardinmenyen Runtime Inputs
- Velg variabelen Parameter Value
- Lagre kommandoen
Trinn 6: Test øvelsen
Nå som kjeden er fullført, kan du teste resultatet
- Publiser kjeden
- Klikk på Execute og velg deretter Run With Inputs
- Finn frem til Connection ID
- Gå til regnearket CLP Employee Overview Spreadsheet
- I Tilkoblinger-panelet finner du CLP Employee Detail by Country Query Connection og klikker på opp-pilen. Når rullegardinmenyen vises, velger du View Properties
- Kopier tilkoblings-ID-en - sørg for at du ikke glemmer noen tegn eller legger til noen mellomrom
- Gå tilbake til Chain Builder, og lim inn tilkoblings-ID-en i feltet Connection ID Runtime Input
- Fyll ut parameterinndataene
- Parameternavn: navnet på parameteren i spørringen - i denne øvelsen er parameternavnet Land
- Parameterverdi: verdien som spørringen skal filtreres på - i denne øvelsen vil vi filtrere på Brazil
- Merk: Hvis du velger en annen parameterverdi enn den som allerede er lagret i regnearket, overskrives regnearket, og dataene våre endres fra Australia til Brasil.
- Klikk på Start
- Når kjeden er fullført, kan du navigere tilbake til regnearket og se at tilkoblingen har blitt oppdatert!
Vellykket kjedekjøring:
Vellykket oppdatering av tilkoblingen:
Lær mer om hvordan du oppdaterer tilkoblinger ved hjelp av kjeder ved å fullføre neste bane: Oppdatere listen over tilkoblinger!