Workiva-ondersteuningscentrum

Met Chainskunt 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 Builderrangschik en verbind je de taken—of commando's—die een keten moet uitvoeren.

Opmerking: Alleen Werkruimte-eigenaren of keten-eigenaren hebben toegang tot Chain Builder. Klik in Wdata op Chainsen vervolgens op Open Chain Builder.

Met de oefeningen in Aan de slag met tabellen en Aan de slag met query'smaakt 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 ingesteld, kunt u de keten toevoegen in Chain Builder:

1. Klik in Wdata op Ketens , Ketenbouwer.
2. Klik op Bouwen, Ketens, en klik vervolgens op Toevoegen, Keten maken in de rechterbenedenhoek.
   

3. 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.

4. 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 eventtoe.

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 eventsplay_for_work, verplaats Runtime inputstouch_app naar Start, en klik op Editcreate.
2. Voer onder Basisinfoeen unieke naam en beschrijving in om het evenement te identificeren.
   

3. Voeg onder Variabelenvariabelen 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 connectorende optie Workivaen sleep Query uitvoeren naar het canvas.

2. Sleep een link van Start naar Query uitvoerenen klik op Bewerkenvan de opdracht.

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

   

3. Voer onder Basisinfoeen unieke naam en beschrijving in om het commando te identificeren.
4. Selecteer onder Command propertiesde 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 Parametersen voert u de bijbehorende sleutel/waarde-paren in:

   Sleutel	Waarde
   PY of Vorig_Jaar	Onder Triggerselecteer je de runtime-input voor het vorige jaar.
   CY of huidig_jaar	Onder Triggerselecteer je de runtime-input voor het huidige jaar.
   Huidige_periode	Onder Triggerselecteer 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. Onder Beschikbare connectorenselecteer je Workivaen sleep je Exporteer queryresultaatnaar het canvas.
2. Sleep een link van Query uitvoeren naar Queryresultaat exporterenen klik op Bewerken voor de laatste.
   
3. Voer onder Basisinfoeen unieke naam en beschrijving in om het commando te identificeren.
4. Selecteer onder Command propertiesdezelfde 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 Publicerenen 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.