Workiva kundestøttesenter

Trinn 1: Rediger eksisterende kjede

• Gå til Chain Builder, og finn frem til kjeden CLP | Avlesning fra et kontrollark
• Klikk på blyantknappen for å redigere kjeden
• Klikk på Kjedeinnstillinger øverst til høyre
  • Gi kjeden et nytt navn: CLP | Bruke verdier fra et kontrollark
• Redd kjeden

Trinn 2: Konverter kontrollarket til JSON

For å kunne utnytte verdiene i et kontrollark på en effektiv måte, konverterer vi utdataene fra kommandoen Get Sheet Data fra CSV-format til JSON. Denne konverteringen etablerer nøkkelverdipar mellom overskriftene i kontrollarket og de tilsvarende verdiene i radene under hver overskrift, noe som muliggjør effektiv iterasjon.

• Legg til en CSV til JSON -kommando fra JSON Connector til Chain-lerretet
• Koble kommandoen Get Sheet Data til kommandoen CSV to JSON
• Dobbeltklikk på kommandoen for å konfigurere den
  • Gi kommandoen et navn: Konverter kontrollark til JSON
  • Klikk på feltet Input File
    • Klikk på nedoverpilen i panelet Velg en variabel for å utvide Hent arkdata
    • Velg utgangen Data
  • La avgrensningsfeltet være Komma (,)
  • Lagre kommandoen
    

Trinn 3: Legg til en kommandogruppe

Legg til en Command Group i kjeden for å muliggjøre iterasjon over hver rad i kontrollarket. På denne måten kan vi skyve hver rad i kontrollarket gjennom serien med kommandoer for gruppen.

• Legg til en Command Group på Chain-lerretet
• Koble kommandoen Convert Control Sheet to JSON til I delen av kommandogruppen
• Dobbeltklikk på kommandogruppen for å konfigurere den
  • Gi gruppen et navn: Kontrollark Iterator
  • Gå til fanen Iteratorer
    • Aktiver Iterasjoner og klikk på feltet Iterasjoner
      
      • Klikk på nedoverpilen i panelet Velg en variabel for å utvide Konverter kontrollark til JSON
      • Velg JSON utdata
  • Lagre kommandoen

Nå som kommandoen er konfigurert, vil den gå gjennom hver rad i kontrollarket og gi en utdata for hver linje.

Trinn 4: Legg til en betinget kommando

I et kontrollark kan brukerne bestemme om de vil at en bestemt rad skal kjøres i en arbeidsflyt. Dette utnyttes via kolonnen ActiveFlag. Vi vil bruke en betinget kommando for å avgjøre om arbeidsflyten må fortsette for hver rad i kontrollarket.

• Legg til en Betinget kommando Kjedehendelse i Chain-lerretet
• Koble gruppen Start i Control Sheet Iterator Group til Conditional Command
  
• Dobbeltklikk på kommandoen for å konfigurere den
  • Hva heter kommandoen? Aktivt flagg?
  • La betingelsen være AND, og klikk på + RULE -knappen
  • Dobbeltsjekk at datatypen er satt til String og endre operasjonen for å teste fra Is Blank til =
  • Klikk i det åpne feltet på venstre side av kommandoen (verdien som skal testes)
    • Fra Velg en variabel -panelet, klikk på nedoverpilen for å utvide Group Iterator
    • Velg <> JSON File Iteration
    • Klikk på den grønne JSON File Iteration -pillen for å transformere variabelen
      • Klikk på Velg en transformasjon, og velg Hent verdi fra JSON
      • Trykk på det grønne + tegnet
      • I verdifeltet skriver du inn overskriften ActiveFlag nøyaktig slik den er i kontrollarket, og trykker enter
      • Velg en annen transformasjon og velg Små bokstaver
      • Trykk på det grønne + tegnet
      • Klikk på Godta

• • Tilbake i Conditional Command, på høyre side (verdien som skal sammenlignes), skriver du inn ordet true
    • Sørg for at dette er skrevet med små bokstaver, siden variabeltransformasjonen som ble brukt tidligere, gjør at Active Flag-verdien blir skrevet med små bokstaver. 
• Lagre kommandoen

Trinn 5: Send utdataene til en kommando

På dette tidspunktet er kontrollarkets iterator satt opp til å gi verdier til alle kommandoer som finnes i gruppestart i kommandogruppen. Vi vil bruke en Handlebars-kommando som plassholder for å vise de hentede verdiene, som også kan brukes iterativt i etterfølgende kommandoer.

• Legg til en Render Text Template Command fra Handlebars Connector til Chain-lerretet
• Koble til Active Flag? Kommando til Render Text Template Kommando
• Dobbeltklikk på kommandoen for å konfigurere den
  
  • Gi kommandoen et navn: Capture Control Sheet-verdier
  • I feltet Template skriver du inn følgende informasjon:
    • Øverste rad: Informasjon om kontrollark
    • Andre rad: Filnavn: <JSON File Iteration&gt
      • Erstatt <JSON File Iteration> fra Select a Variable -panelet, klikk på nedpilen for å utvide Group Iterator
      • Velg <> JSON File Iteration

• • • • Klikk på den grønne JSON File Iteration -pillen for å transformere variabelen
        • Klikk på Velg en transformasjon, og velg Hent verdi fra JSON
          
          
        • Trykk på det grønne + tegnet
        • Skriv inn FileName i verdifeltet nøyaktig slik det står i kontrollarket, og trykk enter
        • Klikk på Godta

• • Gjenta trinnene for tredje, fjerde og femte rad
    • Erstatt <JSON File Iteration> plassholderen med variabelen fra kontrollarket.
      • Tabell-ID: <JSON-fil-iterasjon&gt
        • Følg samme fremgangsmåte som tidligere, men bruk TableID i stedet for FileName.
      • Regneark-ID: <JSON-fil-iterasjon&gt
        • Følg de samme trinnene som tidligere, men bruk SpreadsheetID i stedet for FileName.
      • Filplassering: <JSON-fil-iterasjon&gt
        • Følg de samme trinnene som før, men bruk FileLocation i stedet for FileName.
• Lagre kommandoen

Merk: Følg de skisserte trinnene for å trekke ut en overskrift og hente de tilsvarende radverdiene fra et kontrollark.

Trinn 6: Test øvelsen

Nå som kjeden er ferdig, kan du teste resultatet.

• Publiser kjeden
• Klikk på Execute og velg deretter Run Chain
• Når kjeden er fullført, klikker du på kommandoen Capture Control Sheet Values for å bekrefte at den er vellykket
  • La kjeden fullføres helt før du klikker på kommandoen
• Det vil være et felt der det står Verdi 1
  • Hvis du klikker på dette feltet, vises det at kommandoen har behandlet tre forskjellige verdier, disse verdiene er de tre radene med data fra kontrollarket
• Klikk på feltet Log for hver enkelt verdi, og kontroller at den stemmer overens med verdiene i kontrollarket

Verdi 1:

Verdi 2:

Verdi 3:

Lær mer om bruk av kontrollark ved å fullføre neste bane: Kjøre prosesser og logge resultater i et kontrollark!