Har du sett webinaret Chains Foundations? Vil du følge med i ditt eget tempo? I denne Connected Learning Path skal vi opprette en kjede som laster ned data fra en kilde, laster opp til en Wdata-tabell og oppdaterer tilkoblinger, i tråd med trinnene som ble tatt under webinaret Chains Foundations.
| Primært bruksområde for virksomheten | Automatisering av rapporteringsarbeidsflyter |
| Primært læringsmål | Lær grunnleggende Chains-konsepter |
| Forutsetninger |
Fyll ut følgende: |
| Støttemal | CLP | Chains Foundations |
Trinn 1: Opprett en kjede
For å automatisere flyttingen av kildedataene til sluttrapportene må vi først opprette en kjede som orkestrerer prosessen fra start til slutt. Siden vi alltid vil bruke det samme regnearket og den samme tabellen, setter vi opp kjedevariabler for å lagre disse opplysningene slik at vi får konsekvent tilgang.
- Opprett en ny Chain, og gi kjeden et navn: CLP | Chains Foundations.
-
Under Kjedevariabler klikker du på plusstegnet to ganger for å opprette to kjedevariabler og konfigurere dem som beskrevet nedenfor:
Variabel 1:
- Type: Kjedevariabel (cv)
- Navn: cv-Spreadsheet ID
- Verdi:ID-en til CLP Company Spend by Department-regnearket som ble opprettet i Wdata Foundations CLP.
- Slik finner du regneark-ID-en:
- Gå til CLP Company Spend by Department Spreadsheet.
- I URL-adressen velger du regneark-ID-en, som du finner etter "
regneark/" og før "/regneark".
Regneark-ID-en vises for eksempel i fet skrift her: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
Variabel 2:
- Type: Kjedevariabel (cv)
- Navn: cv-Table ID
- Verdi: legg inn ID-en til CLP Company Spend Table.
- Slik finner du tabell-ID-en:
- Gå til CLP Company Spend Table.
- I URL-adressen velger du tabell-ID-en, som du finner etter "
table/".
Tabell-ID-en vises for eksempel i fet skrift her: app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
- Lagre kjeden.
Trinn 2: Last ned fil
HTTP Request Get-kommandoen brukes til å laste ned filen som skal lastes opp til tabellen. Vi har lagt ut filer på nettet som Chain kan laste ned for å demonstrere nedlasting av filer fra skyen. For å gjøre denne prosessen dynamisk, legger vi til den aktuelle perioden i URL-en, som tilsvarer måneden vi befinner oss i, og sørger for at vi henter det aktuelle datasettet.
- Legg til en Get -kommando fra HTTP Request -kontakten i startområdet.
- Dobbeltklikk på kommandoen for å konfigurere den.
- Fyll ut URL -feltet med innholdet nedenfor, ved hjelp av en variabel for å generere den aktuelle måneden, som tilsvarer perioden:
https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv. - Erstatt <System.DateTime> med kjøretidsvariabelen for systemdato og -klokkeslett.
- I Velg en variabel -panelet klikker du på nedoverpilen for å utvide Runtime.
- Velg System.DateTime.
- Klikk på variabelen System.DateTime for å transformere den. Bruk følgende verdier:
- For Select Transformation:, velg Parse Date/Time.
- Klikk på + -knappen.
- For Format dropdown:, velg ISO Extended (Platform Standard).
- For Utdatadatoformat:, velg %m.
Denne utdataen betyr at vi bare får oppgitt den tosifrede måneden fra systemdatoen og -klokkeslettet.
Les mer om vanlige dato- og tidstransformasjoner her. - I feltene Input date timezone og Output date timezone velger du den aktuelle tidssonen.
- Klikk på ACCEPT.
- Fyll ut URL -feltet med innholdet nedenfor, ved hjelp av en variabel for å generere den aktuelle måneden, som tilsvarer perioden:
- Oppdater feltet Content type til: application/csv.
- Lagre kommandoen.
Trinn 3: Opprett fil
Opplasting av en fil til en Wdata-tabell er en totrinnsprosess. Filen må først opprettes i statusen Staged før den kan importeres for endelig bruk. Vi bruker kommandoen Create File til å opprette filen i Wdata-tabellen i statusen Staged, noe som indikerer at den er opprettet, men ennå ikke importert som et datasett.
- Legg til en Create File -kommando fra Workiva Connector i Chain-lerretet.
- Koble kommandoen Get til kommandoen Create File.
- Dobbeltklikk på kommandoen for å konfigurere den.
- Klikk på feltet Table ID.
- Klikk på nedoverpilen i det venstre Velg en variabel -panelet for å utvide Kjede.
- Velg cv-Table ID.
- Klikk på feltet File.
- Klikk på nedoverpilen i det venstre Velg en variabel -panelet for å utvide GET.
- Velg Svar.
- Fyll ut feltet Navn med informasjonen nedenfor, og følg de samme trinnene som tidligere for å fylle ut perioden i navnefeltet:
ERPSpendData<System.DateTime>.csv - Erstatt <System.DateTime> med kjøretidsvariabelen for systemdato og -klokkeslett.
- Klikk på nedoverpilen i det venstre Velg en variabel -panelet for å utvide Runtime.
- Velg System.DateTime.
- Klikk på variabelen System.DateTime for å transformere den.
- For Select Transformation, velg Parse Date/Time.
- Klikk på knappen + .
- For Format, velg ISO Extended (Platform Standard).
- For Output date format, velg %m-%d-%Y@T%H:%M.
Denne utdataen betyr at vi bare får oppgitt full dato og klokkeslett for når kjeden kjøres.
Les mer om vanlige dato- og tidstransformasjoner her. - I feltene Input date timezone og Output date timezone velger du den aktuelle tidssonen.
- Klikk på ACCEPT.
- Klikk på feltet Table ID.
- Klikk på Lagre for å lagre kommandoen.
Trinn 4: Importer fil til tabell
Det andre trinnet i prosessen med å laste opp filer til Wdata-tabeller er å importere dataene, slik at de kan brukes i spørringer. Dette trinnet tar den iscenesatte filen og importerer den til den angitte tabellen som et datasett.
- Legg til kommandoen Import File into Table fra Workiva Connector i Chain canvas.
- Koble kommandoen Create File til kommandoen Import File into Table.
- Dobbeltklikk på kommandoen for å konfigurere den.
- Klikk på feltet Table ID.
- Klikk på nedoverpilen i det venstre Velg en variabel -panelet for å utvide Kjede.
- Velg cv-Table ID.
- Klikk på feltet File ID.
- Klikk på nedoverpilen i det venstre Velg en variabel -panelet for å utvide Opprett fil.
- Klikk på nedoverpilen for å utvide Resultat.
- Velg Id.
- Lagre kommandoen.
Trinn 5: 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 kommandoen Import File to Table til kommandoen List Connections.
- Dobbeltklikk på kommandoen for å konfigurere den.
- Destinasjonstype: Regneark
- Destinasjons-ID: Bruk Spreadsheet ID Kjedevariabel
- Klikk på feltet Destinasjons-ID.
- Utvid rullegardinmenyen Chain i det venstre variabelpanelet.
- Velg variabelen Spreadsheet ID.
- Lagre kommandoen.
Trinn 6: Kommandogruppe
Vi vil bruke en kommandogruppe 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.
- I Velg en variabel -panelet klikker du på nedoverpilen for å utvide List Connections.
- Velg utgangen Connections.
- Lagre kommandogruppen.
Trinn 7: 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 i Chain-lerretet.
- Koble Start -delen fra Group Iterator til Refresh Connection -kommandoen.
- Dobbeltklikk på kommandoen for å konfigurere den.
- For Tilkoblings-ID: bruker du tilkoblings-ID-en fra Group iterator - Connections Iteration. 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.
- Merk av i avmerkingsboksen Use Previous Source Parameters.
- For Tilkoblings-ID: bruker du tilkoblings-ID-en fra Group iterator - Connections Iteration. Dette gjør at vi kan sende ID-en for den gjeldende iterasjonen videre til Refresh Connections-kommandoen
Trinn 8: Test øvelsen
Nå som kjeden er ferdig, kan du teste resultatet.
- Publiser the Chain.
- Klikk på Utfør og deretter på Kjør kjede.
- Når kjeden er fullført, kan du navigere tilbake til tabellen og se at dataene er lastet inn, navigere til regnearket og se at tilkoblingen har blitt oppdatert.