Workiva supportcenter

Har du tittat på webbinariet Chains Foundations? Vill du följa med i din egen takt? I denna Connected Learning Path kommer vi att skapa en kedja som hämtar data från en källa, laddar upp till en Wdata-tabell och uppdaterar anslutningar, genom att följa de steg som togs under webbseminariet Chains Foundations.

Steg 1: Skapa en kedja

För att automatisera förflyttningen av källdata till våra slutrapporter måste vi först skapa en kedja som styr processen från början till slut. Eftersom vi alltid kommer att använda samma kalkylark och tabell kommer vi att skapa kedjevariabler för att lagra dessa uppgifter för konsekvent åtkomst.

1. Skapa en ny kedja, och namnge kedjan: CLP | Chains Foundations.

2. Under Kedjevariablerklickar du på plustecknet två gånger för att skapa två kedjevariabler och konfigurera dem enligt beskrivningen nedan:

   Variabel 1:

   • typ: Kedja variabel (cv)
   • Namn: cv-ID för kalkylark
   • Värde: Mata in ID för kalkylarket CLP Company Spend by Department som skapades i Wdata Foundations CLP
   • För att hitta kalkylbladets ID:
     1. Navigera till CLP Företagets utgifter per avdelning Kalkylblad.
     2. I URL:en väljer du ID för kalkylarket, som finns efter "spreadsheet/" och före "/sheet"Till exempel är kalkylarkets ID fetmarkerat här: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/
        6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13 

   Variabel 2:

   • typ: Kedja variabel (cv)
   • Namn: cv-Tabell-ID
   • Värde: ange ID för CLP-tabellen för företagsutgifter
   • För att hitta tabell-ID:
     1. Navigera till CLP Company Spend Table.
     2. I URL:en väljer du tabell-ID:t, som finns efter "table/"
        Tabell-ID:t visas till exempel i fetstil här: app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
3. Rädda kedjan

Steg 2: Ladda ner arkivering

Kommandot HTTP Request Get används för att ladda ner den fil som ska laddas upp till tabellen. Vi har lagt upp filer online som Chain kan ladda ner för att demonstrera nedladdning av filer från molnet. För att göra den här processen dynamisk lägger vi till den aktuella perioden i URL:en, vilket motsvarar den månad vi befinner oss i och säkerställer att vi hämtar den aktuella datauppsättningen.

1. Lägg till ett Get -kommando från HTTP Request -anslutningen till startområdet
2. Dubbelklicka på kommandot för att konfigurera det
   1. Fyll i fältet URL med innehållet nedan och använd en variabel för att generera den aktuella månaden, som motsvarar perioden: 
      https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv.
   2. Ersätt <System.DateTime> med exekveringsvariabeln för systemdatum och -tid
   3. I panelen Välj en variabel klickar du på nedåtpilen för att expandera Exekvering
   4. Välj System.DateTime
   5. Klicka på variabeln System.DateTime för att omvandla den Använd följande värden:
      1. För Välj Transformation:, välj Parse Date/Time.
      2. Klicka på knappen
      3. Rullgardinsmeny för format: välj ISO Extended (Platform Standard)
      4. För Utdatadatumformat:, välj %m.
         Denna utdata innebär att vi endast får den tvåsiffriga månaden från systemets datum och tid.
         Läs mer om vanliga datum- och tidstransformationer här.
      5. Välj aktuell tidszon i fälten Tidszon för inmatningsdatum och Tidszon för utmatningsdatum
      6. Klicka på Godkänn.
         
3. Uppdatera fältet Content type till: application/csv
4. Spara kommandot

Steg 3: Skapa arkivering

Uppladdning av en fil till en Wdata-tabell är en process i två steg. Filen måste först skapas i statusen Staged innan den kan importeras för slutlig användning. Vi kommer att använda kommandot Create File för att skapa filen i Wdata Table i statusen Staged, vilket indikerar att den har skapats men ännu inte importerats som ett dataset.

1. Lägg till en Create File Command från Workiva Connector till Chain canvas
2. Anslut kommandot Get till kommandot Create File
3. Dubbelklicka på kommandot för att konfigurera det
   1. Klicka på fältet Table ID
      1. I den vänstra Välj en variabel panelen klickar du på nedåtpilen för att expandera Kedja
      2. Välj cv-Table ID
   2. Klicka på fältet File
      1. Klicka på nedåtpilen i den vänstra panelen Välj en variabel för att expandera GET
      2. Välj Svar
   3. Fyll i fältet Namn med informationen nedan och följ samma steg som tidigare för att fylla i perioden i namnfältet:
      ERPSpendData<System.DateTime>.csv
   4. Ersätt <System.DateTime> med exekveringsvariabeln för systemdatum och -tid
      1. I den vänstra Välj en variabel panelen klickar du på nedåtpilen för att expandera Exekvering
      2. Välj System.DateTime
      3. Klicka på variabeln System.DateTime för att omvandla den
         1. För Select Transformation, välj Parse Date/Time.
         2. Klicka på knappen
         3. För Format, välj ISO Extended (Platform Standard).
         4. För Utdatadatumformat, välj %m-%d-%Y@T%H:%M.
            Detta resultat innebär att vi endast kommer att få tillgång till hela datumet och tiden för när kedjan körs.
            Läs mer om vanliga datum- och tidstransformationer här.
         5. Välj aktuell tidszon i fälten Tidszon för inmatningsdatum och Tidszon för utmatningsdatum
         6. Klicka på Godkänn.
            
4. Klicka på Save för att spara kommandot.

Steg 4: Importera arkivering till tabell

Det andra steget i processen för att ladda upp filer till Wdata-tabeller är att importera data, så att de blir användbara i Queries. Detta steg tar den arrangerade filen och importerar den till den angivna tabellen som ett dataset.

1. Lägg till en Import File i tabell Kommando från Workiva Connector till Chain canvas
2. Anslut kommandot Create File till kommandot Import File into Table
3. Dubbelklicka på kommandot för att konfigurera det
4. Klicka på fältet Table ID
   1. I den vänstra Välj en variabel panelen klickar du på nedåtpilen för att expandera Kedja
   2. Välj cv-Table ID
5. Klicka på fältet File ID
   1. Klicka på nedåtpilen i den vänstra panelen Select a Variable för att expandera Create File
   2. Klicka på nedåtpilen för att expandera Resultat
   3. Välj Id
6. Spara kommandot

Steg 5: Lista anslutningar

Vi kommer att använda kommandot List Connections för att hämta listan över Connection ID:n som är associerade med kalkylarkets ID. Utdata från kommandot List Connections blir en JSON-fil som består av varje Connection i kalkylarket med information om Connection, inklusive Connection ID.

1. Lägg till en List Connections Command från Workiva Connector till Chain canvas
2. Anslut importfilen till tabellen Kommando till listanslutningarna Kommando
3. Dubbelklicka på kommandot för att konfigurera det
   • Mål Typ: Kalkylark
   • Mål ID: Använd ID för kalkylark Kedjevariabel 
     1. Klicka på fältet Destination ID
     2. I den vänstra variabelpanelen, expandera rullgardinsmenyn Chain
     3. Välj variabeln ID för kalkylark
4. Spara kommandot

Steg 6: Kommandogrupp

Vi kommer att använda en Command Group för att möjliggöra iteration över varje Connection. Group Iterator kommer att driva varje Connection på kalkylarket genom följande steg, ett efter ett.

1. Lägg till en Command Group till Chain canvas
2. Anslut Listanslutningar Command till I avsnitt i Command Group
3. Dubbelklicka på kommandot för att konfigurera det
   1. Namnge gruppen: Anslutningar Iteration
   2. Navigera till fliken Iteratorer
   3. Aktivera växlingsknappen Iterations och klicka på fältet Iterations
      1. I panelen Välj en variabel klickar du på nedåtpilen för att expandera Lista anslutningar
      2. Välj Anslutningar utdata 
4. Spara kommandogruppen.

Steg 7: Uppdatera anslutningen

Vi kommer att använda kommandot Refresh Connection för att uppdatera våra Connections med hjälp av Connection ID från iterationen.

1. Lägg till en Refresh Connection Command från Workiva Connector till Chain canvas
2. Anslut avsnittet Starta från Group Iterator till Uppdatera anslutning Kommando
3. Dubbelklicka på kommandot för att konfigurera det
   • Connection ID: använd Connection ID från Group iterator - Connections Iteration. Detta gör att vi kan skicka ID:t för den aktuella iterationen vidare till Refresh Connections Command
     1. Klicka på fältet Connection ID
     2. I den vänstra panelen expanderar du rullgardinsmenyn Group Iterator
     3. Expandera rullgardinsmenyn Connections Iteration
     4. Välj variabeln ConnectionId
   • Markera kryssrutan Use Previous Source Parameters

Steg 8: Testa övningen

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

1. Publicera kedjan.
2. Klicka på Execute och sedan på Run Chain
3. När kedjan har slutförts, navigera tillbaka till tabellen och se att data har laddats, navigera till kalkylarket och se att anslutningen har uppdaterats framgångsrikt!

Framgångsrik kedjekörning:

Data har lagts till i tabellen:

Anslutningar uppdaterade: