Workiva-ondersteuningscentrum

Hebt u het Chains Foundations Webinar bekeken? Wilt u in uw eigen tempo meelopen? In dit Connected Learning Path maken we een Chain die gegevens downloadt van een bron, uploadt naar een Wdatatabel en verbindingen ververst, waarbij we de stappen volgen die tijdens het Chains Foundations Webinar zijn genomen.

Stap 1: Maak een ketting

Om het verplaatsen van onze brongegevens naar onze eindrapporten te automatiseren, moeten we eerst een Chain maken die het proces van begin tot eind orkestreert. Aangezien we altijd dezelfde spreadsheet en tabel zullen gebruiken, zullen we kettingvariabelen instellen om deze gegevens op te slaan voor consistente toegang.

1. Maak een nieuwe Chain, en geef de Chain een naam: CLP | Chains Foundations.

2. Klik onder Chain Variables twee keer op het plusteken om twee Chain Variables aan te maken en ze te configureren zoals hieronder beschreven:

   Variabele 1:

   • Type: Ketting variabel (cv)
   • Naam: cv-Spreadsheet ID
   • Waarde:De ID van de CLP Bedrijfsuitgaven per afdeling-spreadsheet die is gemaakt in de Wdata Foundations CLP.
   • Om de Spreadsheet-ID te vinden:
     1. Navigeer naar het werkblad CLP Bedrijfsuitgaven per afdeling.
     2. Selecteer in de URL de werkblad-ID, die te vinden is na "spreadsheet/" en vóór "/sheet".
        De Spreadsheet-ID wordt hier bijvoorbeeld vet weergegeven: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13

   Variabele 2:

   • Type: Ketting variabel (cv)
   • Naam: cv-Tabel ID
   • Waarde: voer het ID van de CLP Bedrijfsuitgaven Tabel in.
   • Om de Table ID te vinden:
     1. Navigeer naar de CLP Company Spend Table.
     2. Selecteer in de URL de tabel-ID, die te vinden is na "table/".
        De tabel-ID wordt hier bijvoorbeeld vet weergegeven: app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
3. Sla de ketting op.

Stap 2: Bestand downloaden

Het HTTP Request Get commando wordt gebruikt om het bestand te downloaden dat naar de tabel geüpload zal worden. We hebben bestanden online gehost zodat de Chain ze kan downloaden om het downloaden van bestanden uit de cloud te demonstreren. Om dit proces dynamisch te maken, voegen we de huidige periode toe aan de URL, die overeenkomt met de maand waarin we ons bevinden en ervoor zorgt dat we de huidige gegevensset ophalen.

1. Voeg een opdracht Get van de HTTP Request connector toe aan het startgebied.
2. Dubbelklik op de opdracht om deze te configureren.
   1. Vul het veld URL met de onderstaande inhoud, met behulp van een variabele om de huidige maand te genereren, die overeenkomt met de periode:
      https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv.
   2. Vervang <System.DateTime> door de runtimevariabele voor systeemdatum en -tijd.
   3. Klik in het paneel Een variabele selecteren op de pijl omlaag om Runtime uit te vouwen.
   4. Selecteer System.DateTime.
   5. Klik op de variabele System.DateTime om deze te transformeren. Gebruik de volgende waarden:
      1. Voor Selecteer Transformatie:, selecteer Datum/tijd parseren.
      2. Klik op de knop +.
      3. Voor Formaat vervolgkeuzelijst:, selecteer ISO Extended (Platform Standaard).
      4. Voor Uitvoer datum formaat:, selecteer %m.
         Deze uitvoer betekent dat we alleen de tweecijferige maand van de systeemdatum en -tijd krijgen.
         Hier vindt u meer informatie over veelgebruikte datum- en tijdtransformaties.
      5. Selecteer in het veld Input date timezone en Output date timezone uw huidige tijdzone.
      6. Klik op ACCEPT.
         
3. Werk het veld Inhoudstype bij tot: application/csv.
4. Sla de opdracht op.

Stap 3: Bestand maken

Het uploaden van een bestand naar een Wdatatabel verloopt in twee stappen. Het bestand moet eerst aangemaakt worden in de status Staged voordat het geïmporteerd kan worden voor definitief gebruik. We zullen de opdracht Bestand maken gebruiken om het bestand binnen de Wdatatabel in de status Staged te maken, wat aangeeft dat het is gemaakt maar nog niet als een dataset is geïmporteerd.

1. Voeg een Create File commando van de Workiva Connector toe aan het Chain canvas.
2. Verbind de opdracht Get met de opdracht Create File.
3. Dubbelklik op de opdracht om deze te configureren.
   1. Klik op het veld Table ID.
      1. Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Keten uit te vouwen.
      2. Selecteer cv-Table ID.
   2. Klik op het veld Bestand.
      1. Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om GET uit te vouwen.
      2. Selecteer Response.
   3. Vul het veld Name met de onderstaande informatie en volg dezelfde stappen als eerder om de Periode in het naamveld in te vullen:
      ERPSpendData<System.DateTime>.csv
   4. Vervang <System.DateTime> door de runtimevariabele voor systeemdatum en -tijd.
      1. Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Runtime uit te vouwen.
      2. Selecteer System.DateTime.
      3. Klik op de variabele System.DateTime om deze te transformeren.
         1. Voor Selecteer Transformatie, selecteer Datum/tijd parseren.
         2. Klik op de knop + .
         3. Selecteer voor Formaat ISO Extended (Platform Standaard).
         4. Voor Uitvoer datum formaat, selecteer %m-%d-%Y@T%H:%M.
            Deze uitvoer betekent dat we alleen de volledige datum en tijd krijgen wanneer de ketting wordt uitgevoerd.
            Hier vindt u meer informatie over veelgebruikte datum- en tijdtransformaties.
         5. Selecteer in het veld Input date timezone en Output date timezone uw huidige tijdzone.
         6. Klik op ACCEPT.
            
4. Klik op Opslaan om de opdracht op te slaan.

Stap 4: Importeer bestand naar tabel

De tweede stap in het proces om bestanden te uploaden naar Wdata-tabellen is het importeren van de gegevens, zodat ze bruikbaar worden in Queries. Deze stap neemt het opgevoerde bestand en importeert het in de aangewezen Tabel als een dataset.

1. Voeg een Importbestand in tabel commando van de Workiva Connector toe aan het Chain canvas.
2. Verbind de opdracht Bestand maken met de opdracht Bestand importeren in tabel.
3. Dubbelklik op de opdracht om deze te configureren.
4. Klik op het veld Table ID.
   1. Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Keten uit te vouwen.
   2. Selecteer cv-Table ID.
5. Klik op het veld File ID.
   1. Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Bestand maken uit te vouwen.
   2. Klik op de pijl omlaag om Resultaat uit te vouwen.
   3. Selecteer Id.
6. Sla de opdracht op.

Stap 5: Verbindingen weergeven

We zullen de opdracht List Connections gebruiken om de lijst met verbindings-ID's op te halen die gekoppeld zijn aan de Spreadsheet-ID. De uitvoer van de opdracht List Connections is een JSON-bestand dat bestaat uit elke Verbinding in het werkblad met details over de Verbinding, inclusief de ID van de Verbinding.

1. Voeg een opdracht List Connections van de Workiva Connector toe aan het Chain canvas.
2. Verbind de opdracht Bestand importeren naar tabel met de opdracht Verbindingen weergeven.
3. Dubbelklik op de opdracht om deze te configureren.
   • Type bestemming: Spreadsheet
   • Bestemmings-ID: Gebruik de variabele Spreadsheet ID Chain
     1. Klik op het veld Destination ID (Bestemmings-ID).
     2. Vouw in het linker variabelenpaneel de vervolgkeuzelijst Chain uit.
     3. Selecteer de variabele Spreadsheet ID.
4. Sla de opdracht op.

Stap 6: Opdrachtgroep

We zullen een Commandogroep gebruiken om iteratie over elke Verbinding mogelijk te maken. De Group Iterator zal elke Verbinding op het Spreadsheet één voor één door de volgende stappen duwen.

1. Voeg een Commandogroep toe aan het Chain canvas.
2. Verbind de opdracht List Connections met de sectie In van de Command Group.
3. Dubbelklik op de opdracht om deze te configureren.
   1. Geef de groep een naam: Verbindingen Iteratie
   2. Navigeer naar het tabblad Iterators.
   3. Schakel de optie Iteraties in en klik op het veld Iteraties.
      1. Klik in het paneel Een variabele selecteren op de pijl omlaag om Lijstverbindingen uit te vouwen.
      2. Selecteer de uitgang Connections.
4. Sla de commandogroep op.

Stap 7: Verbinding vernieuwen

We zullen de opdracht Verbinding verversen gebruiken om onze Verbindingen te verversen met behulp van de Verbindings-ID van de iteratie.

1. Voeg een Refresh Connection commando van de Workiva Connector toe aan het Chain canvas.
2. Verbind de sectie Start van de Group Iterator met de opdracht Refresh Connection.
3. Dubbelklik op de opdracht om deze te configureren.
   • Voor Verbindings-ID: gebruikt u de Verbindings-ID van de groep iterator - Verbindingen Iteratie. Hierdoor kunnen we de ID voor de huidige iteratie doorsturen naar de opdracht Verbindingen vernieuwen
     1. Klik op het veld Connection ID.
     2. Vouw in het linkerpaneel de vervolgkeuzelijst Group Iterator uit.
     3. Vouw de vervolgkeuzelijst Connections Iteration uit.
     4. Selecteer de variabele ConnectionId.
   • Schakel het selectievakje Vorige bronparameters gebruiken in.

Stap 8: De oefening testen

Nu de Chain compleet is, kunt u het resultaat testen.

1. Publiceer de keten.
2. Klik op Uitvoeren en vervolgens op Keten uitvoeren.
3. Zodra de Chain voltooid is, navigeert u terug naar de Table en ziet u dat de gegevens geladen zijn, navigeert u naar de Spreadsheet en ziet u dat de verbinding met succes ververst is.

Succesvolle kettingloop

Gegevens toegevoegd aan Tabel

Verbindingen vernieuwd