Workiva-ondersteuningscentrum

Met Chains kunt u routinetaken automatiseren, met eenvoudige integratie om gegevens op te halen of te verzenden tussen meerdere systemen. Je kunt bijvoorbeeld een keten creëren om automatisch financiële informatie uit een gegevensbron in een tabel te halen en die gegevens vervolgens naar een ander systeem te sturen om een ​​rapport te genereren. In Chain Builder rangschik en koppel je de taken—of commando's —die een keten moet uitvoeren.

Opmerking: Alleen Werkruimte-eigenaren of keten-eigenaren hebben toegang tot Chain Builder . Om Chain Builder te
openen, klikt u in Workiva op Chains en vervolgens nogmaals op Chains in het Wdata-tabblad.

Met de oefeningen in Aan de slag met tabellen en Aan de slag met query's maakt u tabellen en query's zoals die worden gebruikt voor financiële rapportage. In deze oefening maken we een keten om die query uit te voeren en de resultaten ervan naar spreadsheets te exporteren. 

Stap 1. Haal de ID en parameters van de query op.

Als je dat nog niet hebt gedaan , download dan de voorbeeldgegevens en voer de oefeningen ' Aan de slag met tabellen ' en ' Aan de slag met query's ' uit, aangezien je de query in de keten zult gebruiken. Noteer de ID van de query; hiermee kunt u de query in de keten identificeren.

Opmerking: Wanneer u een query opent in Wdata, verschijnt de ID ervan na /queries/ in de URL.

Als je de filters van de query hebt gemaakt met parameters in plaats van statische waarden, noteer dan ook de namen van de parameters. Bijvoorbeeld:

• PY of Vorig_Jaar
• CY of huidig_jaar
• Huidige_periode

Stap 2. Maak het spreadsheet aan.

Voordat je de keten maakt, maak je een spreadsheet om de queryresultaten naar te exporteren.

Om misbruik van het spreadsheet te voorkomen, dient het educatieve doel ervan duidelijk in de naam vermeld te worden.

Nadat je de spreadsheet hebt gemaakt, noteer je de URL; je hebt deze nodig om te bepalen waar je de zoekresultaten naartoe moet exporteren. 

Stap 3. Maak de ketting

Nu is het tijd om de ketting te bouwen! Uiteindelijk zal het commando's bevatten om de query uit te voeren en de meest recente resultaten naar spreadsheets te exporteren.

Voordat je een keten aanmaakt, controleer of je de kern Workiva-connector hebt ingesteld die wordt gebruikt om de commando's uit te voeren. Hoewel deze keten slechts één connector nodig heeft, kunnen ketens meerdere connectoren gebruiken om gegevens voor te bereiden en over te dragen tussen uw verschillende systemen.

Nadat de connector is aangesloten, kunt u de ketting toevoegen:

1. Klik in Workiva op Kettingen in het linkernavigatiegebied. Hiermee wordt een nieuw Wdata-tabblad geopend.
2. Klik in Wdata op Ketens .
3. Selecteer in het menu bovenaan de pagina de omgeving waarin u de ketting wilt bouwen.
4. Klik op Maken in de rechterbovenhoek van de pagina en selecteer Keten maken of Keten maken vanuit sjabloon . Deze procedure gaat ervan uit dat u Create Chain hebt geselecteerd.
   
5. In het dialoogvenster 'Ketting bewerken':

   1. Voer een unieke naam en beschrijving in om de ketting te identificeren.

      Opmerking: Ketens verschijnen in Ketenbouwer voor iedereen in de werkruimte; geef ze een naam zodat leden duidelijk begrijpen wat het doel ervan is. Raadpleeg Toonaangevende praktijk: Naamgevingsconventies voor ketens en hun objecten voor meer informatie over naamgeving.

   2. Selecteer of deze keten gelijktijdige uitvoeringen toestaat. 
6. Klik op Opslaan .

Stap 4. Begin met een triggergebeurtenis voor runtime-inputs.

Om de keten te laten beginnen met het opvragen van de variabelen die nodig zijn voor de commando's, voeg een Runtime Inputs trigger event toe.

Tip: Naast runtime-inputs kunt u variabelen toevoegen voor de keten of de werkruimte . Met variabelen kunt u het gebruik van een keten uitbreiden, bijvoorbeeld met elke query of spreadsheet in plaats van alleen een specifieke query of spreadsheet.

1. Klik op Trigger events play_for_work , verplaats Runtime inputs touch_app naar Start , en klik op Edit create .
2. Voer onder Basisinfo een unieke naam en beschrijving in om het evenement te identificeren.
   

3. Voeg onder Variabelen variabelen toe voor:

   • De query-ID
   • Alle queryparameterwaarden
   • De URL van het spreadsheet

   Tip : Klik voor elke variabele op Invoer toevoegen , selecteer Tekstveld en voer de naam, beschrijving en standaardwaarde in.

4. Klik op Opslaan .

Stap 5. Voeg een opdracht toe om de query uit te voeren.

Voeg vervolgens een Run query commando toe, zodat de keten bij elke uitvoering de meest recente resultaten ophaalt. Je gebruikt de runtime-inputs om de query-ID en parameterwaarden te identificeren.

1. Selecteer onder Beschikbare connectoren de optie Workiva en sleep Query uitvoeren naar het canvas.

2. Sleep een link van Start naar Query uitvoeren en klik op Bewerken van de opdracht.

   Opmerking: Zorg ervoor dat u de opdracht koppelt aan Start zodat deze de runtime-invoer kan gebruiken.

   

3. Voer onder Basisinfo een unieke naam en beschrijving in om het commando te identificeren.
4. Selecteer onder Command properties de Workiva connector om de opdracht uit te voeren.
5. Voor Query ID , selecteer de runtime-input van de query-ID onder Trigger .

6. Als de filters van de query parameterwaarden gebruiken, klikt u op Toevoegen ( + ) onder Parameters en voert u de bijbehorende sleutel/waarde-paren in:

   Sleutel	Waarde
   PY of Vorig_Jaar	Onder Trigger selecteer je de runtime-input voor het vorige jaar.
   CY of huidig_jaar	Onder Trigger selecteer je de runtime-input voor het huidige jaar.
   Huidige_periode	Onder Trigger selecteer je de runtime-input voor de huidige periode.

7. Klik op Opslaan .

Stap 6. Voeg een opdracht toe om de resultaten te exporteren.

Voeg nu een opdracht toe om de resultaten van de query naar spreadsheets te exporteren:

1. Selecteer onder Beschikbare connectoren de optie Workiva en sleep Exporteer queryresultaat naar het canvas.
2. Sleep een link van Query uitvoeren naar Queryresultaat exporteren en klik op Bewerken voor de laatste.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om het commando te identificeren.
4. Selecteer onder Command properties dezelfde Workiva connector als Run query .
5. Voor Queryresultaat-ID , selecteer ID voor de Queryresultaat uitvoer onder Query uitvoeren .
6. Voor Spreadsheet-URL , selecteer de runtime-invoer voor de URL van de spreadsheet onder Trigger .
7. Klik op Opslaan .

Stap 7. Laat de ketting lopen

Om de ketting te laten draaien:

1. Klik op Publiceren en vervolgens nogmaals op Publiceren .
2. Klik op Uitvoeren en vervolgens op Uitvoeren met invoer .
3. Voer de waarden voor de runtime-inputs in en klik op Start .
4. Om te controleren of de keten succesvol is, raadpleegt u het spreadsheet voor de queryresultaten.

Als de reeks mislukt, klik dan op de opdrachten in de uitvoeringsgeschiedenis om de logboeken te bekijken en berichten te vinden die kunnen helpen bij het oplossen van de fout.