Automatisering av tilkoblingsoppdateringer er avgjørende for å effektivisere sentralisering og flytting av data til Workiva-plattformen, spesielt når det finnes flere tilkoblinger. I denne Connected Learning Path lærer vi hvordan du oppretter en kjede som oppdaterer en liste over koblinger mellom Wdata og Workiva-plattformen ved hjelp av en regneark-ID. Denne kjeden genererer en liste over tilkoblinger i et enkelt regneark og gir oss deretter en liste over ID-ene til disse tilkoblingene, slik at vi kan automatisere oppdateringen av hver tilkobling i regnearket.
| Primært bruksområde for virksomheten | Datatilkobling mellom Workiva og Wdata |
| Primært læringsmål | Lær hvordan du oppdaterer en liste over tilkoblinger ved hjelp av kjeder |
| Sekundære læringsmål | Lær det viktigste om gruppe-iteratorer |
| Forutsetninger |
Fullfør CLP | Oppdater tilkoblinger med en parameter Gi tillatelser til regnearket for den tilknyttede OAuth Grant-brukeren |
| Støttemal | CLP | Oppdater liste over tilkoblinger |
Trinn 1: Opprett en kjede
- Legg til en ny Kjede
- Gi kjeden et navn: CLP | Oppdater liste over tilkoblinger
- Redd kjeden
Trinn 2: Inndata ved kjøretid
Vi bruker Runtime Inputs-kommandoen til å starte kjeden. Dette gjør det mulig å spesifisere hvilket regneark vi ønsker å oppdatere alle koblingene for.
- Legg til en Runtime Inputs Kjedehendelse fra Chain Trigger Events startnoden
- Rediger Runtime Inputs Chain Event ved å dobbeltklikke på kommandoen
- Type: TextField
- Vis navn: Regneark-ID
- Påkrevd: Krysset av
- Lagre kommandoen
Trinn 3: Oppgi tilkoblinger
Vi bruker kommandoen List Connections til å hente frem listen over tilkoblings-ID-er som er knyttet til regneark-ID-en. Utdataene fra kommandoen List Connections vil være en JSON-fil som består av hver tilkobling i regnearket med detaljer om tilkoblingen, inkludert tilkoblings-ID.
- Legg til en List Connections -kommando fra Workiva Connector til Chain-lerretet
- Koble Runtime Inputs Command til List Connections Command
- Dobbeltklikk på kommandoen for å konfigurere den
- Destinasjonstype: Regneark
- Destinasjons-ID: Bruk variabelen Spreadsheet ID fra Runtime Inputs - dette gjør at vi kan overføre verdien som er angitt i Chain run time, til Refresh Connections-kommandoen
- Klikk på feltet Destinasjons-ID
- Utvid rullegardinmenyen Trigger i panelet til venstre
- Utvid rullegardinmenyen Runtime Inputs
- Velg variabelen Spreadsheet ID
- Lagre kommandoen
Trinn 4: Kommandogruppe
Vi bruker en Command Group for å muliggjøre iterasjon over hver tilkobling. Group Iterator vil skyve hver tilkobling i regnearket gjennom følgende trinn, ett etter ett.
- Legg til en Command Group på Chain-lerretet
- Koble kommandoen List Connections til In i kommandogruppen
- Dobbeltklikk på kommandoen for å konfigurere den
- Gi gruppen et navn: Tilkoblinger Iterasjon
- Gå til fanen Iteratorer
- Aktiver Iterasjoner og klikk på feltet Iterasjoner
- Klikk på nedoverpilen i panelet Select a Variable for å utvide List Connections
- Velg Tilkoblinger utgang
- Aktiver Iterasjoner og klikk på feltet Iterasjoner
- Lagre kommandogruppen
Trinn 5: Oppdater tilkoblingen
Vi bruker kommandoen Oppdater tilkobling til å oppdatere tilkoblingene våre ved hjelp av tilkoblings-ID-en fra iterasjonen.
- Legg til en Refresh Connection -kommando fra Workiva Connector til Chain-lerretet
- Koble Start -delen fra Group Iterator til Refresh Connection Command
- Dobbeltklikk på kommandoen for å konfigurere den
- Tilkoblings-ID: Bruk Tilkoblings-ID fra Group-iteratoren - Tilkoblingsiterasjon. Dette gjør at vi kan sende ID-en for den gjeldende iterasjonen videre til Refresh Connections-kommandoen
- Klikk på feltet Connection ID
- Utvid rullegardinmenyen Group Iterator i panelet til venstre
- Utvid rullegardinmenyen Connections Iteration
- Velg variabelen ConnectionId
- Bruk tidligere kildeparametere: Avkrysset
- Dette gjør at vi kan oppdatere en tilkobling ved hjelp av de tidligere parameterverdiene fra kilden - i vårt tilfelle vil spørringen med parameteren Land fortsatt oppdateres med Brasil som filterverdi
- Tilkoblings-ID: Bruk Tilkoblings-ID fra Group-iteratoren - Tilkoblingsiterasjon. Dette gjør at vi kan sende ID-en for den gjeldende iterasjonen videre til Refresh Connections-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 regneark-ID-en
- Gå til regnearket CLP Employee Overview Spreadsheet
- I URL-adressen velger du regneark-ID-en, som du finner etter "spreadsheet/" og før "/sheet".
- Regneark-ID-en er for eksempel uthevet her: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Gå tilbake til Chain Builder, og lim inn regneark-ID-en i feltet Regneark-ID
- Klikk på Start
- Når kjeden er fullført, navigerer du tilbake til regnearket og ser at begge tilkoblingene har blitt oppdatert!
Vellykket kjedekjøring med to iterasjoner:
Vellykket oppdatering av tilkoblingen:
Hvis du vil vite mer om hvordan du kan bruke kjeder til å effektivisere datainnsamlingen, kan du lese resten av Data Centralization Paths!