Workiva supportcenter

Steg 1: Redigera befintlig kedja

• Navigera till Chain Builder och leta reda på kedjan CLP | Läsa från en kontrollark
• Klicka på pennknappen för att redigera kedjan
• Klicka på Kedjeinställningar längst upp till höger 
  • Byt namn på kedjan: CLP | Använda värden från ett kontrollark
• Rädda kedjan

Steg 2: Konvertera kontrollarket till JSON

För att effektivt kunna använda värdena i ett kontrollark konverterar vi utdata från kommandot Get Sheet Data från CSV-format till JSON. Denna konvertering skapar nyckel-värde-par mellan rubrikerna i arket och motsvarande värden i raderna under varje rubrik, vilket möjliggör effektiv iteration.

• Lägg till en CSV till JSON Kommando från JSON Connector till Chain canvas
• Anslut kommandot Get Sheet Data till kommandot CSV to JSON
• Dubbelklicka på kommandot för att konfigurera det
  • Namnge kommandot: Konvertera Control Sheet till JSON
  • Klicka på fältet Input File
    • I panelen Välj en variabel klickar du på nedåtpilen för att expandera Hämta data från ark
    • Välj ut Data
  • Lämna fältet för avgränsningstecken som Komma (,)
  • Spara kommandot
    

Steg 3: Lägg till en kommandogrupp

Lägg till en Command Group i kedjan för att möjliggöra iteration över varje rad i arket. Detta gör att vi kan driva varje rad i arket genom serien av kommandon för gruppen.

• Lägg till en Command Group till Chain canvas
• Anslut Convert Control Sheet to JSON Command till In avsnitt i Command Group
• Dubbelklicka på kommandogruppen för att konfigurera den
  • Namnge gruppen: Kontroll ark Iterator
  • Navigera till fliken Iteratorer
    • Aktivera växlingsknappen Iterations och klicka på fältet Iterations
      
      • I panelen Välj en variabel klickar du på nedåtpilen för att expandera Konvertera kontrollark till JSON
      • Välj utdata JSON  
  • Spara kommandot

Nu när kommandot har konfigurerats kommer det att iterera genom varje rad i arket och ge en utdata för varje rad.

Steg 4: Lägg till ett villkorligt kommando

I ett kontrollark kan användarna bestämma om de vill att en viss rad ska utföras i ett arbetsflöde. Detta utnyttjas via kolumnen ActiveFlag. Vi kommer att använda ett villkorligt kommando för att avgöra om arbetsflödet behöver fortsätta för varje rad i arket.

• Lägg till ett villkorligt kommando kedjehändelse i kedjans canvas
• Anslut gruppen Starta inom Kontroll ark Iterator Grupp till Villkorligt Kommando
  
• Dubbelklicka på kommandot för att konfigurera det
  • Namnge befälet: Aktiv flagga?
  • Lämna villkoret som AND och klicka på RULE knapp
  • Dubbelkolla att datatypen är inställd på String och ändra den operation som ska testas från Is Blank till =.
  • Klicka i det öppna fältet på vänster sida av kommandot (värdet som ska testas)
    • I panelen Välj en variabel klickar du på nedåtpilen för att expandera Group Iterator 
    • Välj <> JSON File Iteration
    • Klicka på det gröna JSON File Iteration pillret för att omvandla variabeln
      • Klicka på Select a Transformation och välj Get Value from JSON
      • Tryck på den gröna skylten
      • I värdefältet skriver du in ActiveFlag rubrik exakt som den är i kontrollarket och trycker på Enter
      • Markera en annan transformation och välj Lowercase
      • Tryck på den gröna skylten
      • Klicka på Godkänn

• • Tillbaka i Conditional Command, på höger sida (det värde som ska jämföras), skriver du ordet true
    • Se till att det är små bokstäver, eftersom den variabelomvandling som tillämpades tidigare gör att Active Flag-värdet bara innehåller små bokstäver. 
• Spara kommandot

Steg 5: Mata utdata till ett kommando

Vid denna tidpunkt är iteratorn för kontrollarket inställd på att ge värden till alla kommandon som finns i gruppstarten för kommandogruppen. Vi kommer att använda ett Handlebars-kommando som en platshållare för att visa de hämtade värdena, som också kan användas iterativt i nedströms kommandon.

• Lägg till en Render Text Template Command från Styret Connector till Chain canvas
• Anslut Aktiv flagga? Kommando till Rendera textmall Kommando
• Dubbelklicka på kommandot för att konfigurera det
  
  • Namnge kommandot: Värden för Capture Control Ark
  • I fältet Template skriver du in följande information:
    • Översta raden: Information om kontrollarket
    • Andra raden: Filnamn: <JSON>
      • Byt ut <JSON> från Välj en variabel panelen, klicka på nedåtpilen för att expandera Group Iterator 
      • Välj <> JSON File Iteration 

• • • • Klicka på det gröna JSON File Iteration pillret för att omvandla variabeln
        • Klicka på Select a Transformation och välj Get Value from JSON
          
          
        • Tryck på den gröna skylten
        • I värdefältet skriver du Filnamn exakt som det är i kontrollarket och trycker på Enter
        • Klicka på Godkänn

• • Upprepa stegen för rad tre, fyra och fem
    • Ersätt platshållaren <JSON> med variabeln från kontrollarket.
      • Tabell ID: <JSON>
        •  Följ samma steg som tidigare, men använd TableID istället för FileName.
      • ID för kalkylark: <JSON>
        •  Följ samma steg som tidigare, men använd SpreadsheetID istället för FileName.
      • Filens läge: <JSON>
        •  Följ samma steg som tidigare, men använd FileLocation istället för FileName.
• Spara kommandot

Obs: Följ de översiktliga stegen för att extrahera en rubrik och hämta motsvarande radvärden från ett kontrollark.

Steg 6: Testa övningen

Nu när kedjan är klar kan du testa resultatet.

• Publicera kedjan
• Klicka på Execute och välj sedan Run Chain
• När kedjan har slutförts klickar du på Capture Control Sheet Values Command för att verifiera att det har gått bra
  • Låt kedjan bli helt klar innan du klickar på kommandot
• Det kommer att finnas ett fält där det står Värde 1
  • Om du klickar på det här fältet kommer det att visa att kommandot bearbetade tre olika värden, dessa värden är de tre raderna med data från kontrollarket
• Klicka på fältet Log för varje enskilt värde och kontrollera att det stämmer överens med värdena i arket

Värde 1:

Värde 2:

Värde 3:

Läs mer om hur du använder ark genom att slutföra nästa steg: Kör processer och logga resultat i en kontrollark!