Workiva-ondersteuningscentrum

Met deze keten kunt u de parameterwaarde van een query ophalen uit een spreadsheet - bijvoorbeeld om u te richten op een specifieke entiteit of tijdsperiode - en vervolgens de query uitvoeren en de resultaten exporteren naar een ander blad.

Ingrediënten

Om deze ketting te maken, hebt u nodig:

• Een kern Workiva connector
• Een kernconnector Tabular Transformation

Stap 1. Creëer de ketting

1. Klik in Chain Builder, op het tabblad Chains device_hub op Create chain.
2. Voer onder Setup een unieke naam en beschrijving in om de keten en de bedoeling ervan te helpen identificeren.
3. Voeg onder Variabelen variabelen toe voor de spreadsheets en query om mee te werken.

   Naam	Waarde
   Vraag-ID	Voer de ID van de uit te voeren query in. Tip: In de URL van de query verschijnt de ID na queries/.
   Spreadsheet-ID	Voer de ID in van de spreadsheet met de waarde die moet worden opgehaald voor de parameter van de query. Tip: In de URL van de spreadsheet verschijnt de ID ervan na spreadsheet/.
   Blad ID	Voer de ID in van het blad met de spreadsheet met de waarde die moet worden opgehaald voor de parameter van de query. Tip: In de URL van de spreadsheet verschijnt de ID van het blad na blad/.
   URL van spreadsheet	Om de queryresultaten naar een bestaande spreadsheet te exporteren, voert u de volledige URL in. Opmerking: Als de keten altijd nieuwe spreadsheets aanmaakt op basis van de resultaten van de query, is deze variabele niet nodig.

4. Klik op Opslaan.

Stap 2. Begin met de opdracht Get sheet data

Om de waarde voor de queryparameter op te halen uit de cel van een spreadsheet, start u de keten met een opdracht Get sheet data.

1. Selecteer onder Beschikbare connectoren Workiva en verplaats Bladgegevens ophalen naar Start.
2. Klik op Bewerken voor de opdracht en voer de naam en beschrijving in onder Basisinfo.
3. Selecteer onder Opdrachteigenschappen de connector Workiva om de opdracht uit te voeren.
   
4. Selecteer voor Spreadsheet ID de ketenvariabele met de spreadsheet-ID voor de parameterwaarde.
5. Selecteer voor Sheet Name/ID de kettingvariabele met het blad-ID voor de parameterwaarde.
6. Voer voor Regio de cel in waarvan u de waarde wilt ophalen, in de A1-representatie van [kolom][rij].
7. Selecteer voor Waardestijl of u de onbewerkte of berekende waarde van de cel wilt ophalen. Als de cel bijvoorbeeld 1 + 1 bevat, selecteert u Ruwe waarde voor de expliciete formule, of Berekend voor de som van 2.
8. Voer voor Revisie de revisie in van de spreadsheet waarvan u de waarde wilt ophalen. Voor de huidige versie voert u -1 in.
9. Klik op Opslaan.

Stap 3. Een opdracht Waarde extraheren toevoegen

Om de opgehaalde waarde uit de spreadsheet met de queryparameter te gebruiken, voegt u een opdracht Waarde extraheren toe.

1. Selecteer onder Available Connectors, Tabular Transformation, en verplaats Extract value naar het canvas.
2. Sleep een koppeling van Start naar Extraheer waarde, en klik op Bewerk voor de opdracht.
3. Voer onder Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.
4. Selecteer onder Command properties de connector Tabular Transformation om de opdracht uit te voeren.
5. Selecteer voor Input file de Data uitvoer van de opdracht Get sheet data.
   
6. Aangezien de opdracht Get sheet data alleen de waarde van één cel ophaalt, laat u Kolomindex, Scheidingsteken, en Rij-index met hun respectieve standaardwaarden 0, Komma, en 1.
7. Klik op Opslaan.

Stap 4. Een opdracht Query uitvoeren toevoegen

Om de opgehaalde waarde als parameter toe te passen en vervolgens de query uit te voeren, voegt u een opdracht Query uitvoeren toe.

1. Selecteer onder Beschikbare connectoren, Workiva, en verplaats Uitvoeren query naar het canvas.
2. Sleep een koppeling van Waarde uitpakken naar Query uitvoeren, en klik op bewerken voor de laatste.
3. Voer onder Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.
4. Selecteer onder Command properties dezelfde Workiva connector als Get sheet data.
5. Selecteer voor Query ID de ketenvariabele voor de query ID.
6. Klik onder Parameters op Toevoegen en pas de waarde uit de spreadsheet toe op de parameter van de query:
   • In Key, voert u de naam van de parameter in om de waarde te gebruiken.
   • Selecteer in Waarde de uitvoer Waarde van de opdracht Waarde uitpakken.
7. Klik op Opslaan.

Stap 5. Een opdracht Exporteer queryresultaat toevoegen

Om de resultaten van de query naar Spreadsheets te exporteren, voegt u een opdracht Queryresultaten exporteren toe.

1. Selecteer onder Beschikbare connectoren, Workiva, en verplaats Uitvoeren query naar het canvas.
2. Sleep een koppeling van Query uitvoeren naar Queryresultaat exporteren, en klik op voor de laatste.
3. Voer onder Basisinfo een naam en beschrijving in om de opdracht te helpen identificeren.
4. Selecteer onder Command properties dezelfde Workiva connector als Get sheet data.
   
5. Voor Query resultaat ID, selecteert u ID uit de Query resultaat uitvoer van de opdracht Uitvoeren query.
6. Geef voor Spreadsheet URL aan of u de resultaten naar een nieuwe of bestaande spreadsheet wilt exporteren:
   • Om naar een nieuwe spreadsheet te exporteren, laat u Spreadsheet URL leeg.
   • Om naar een bestaande spreadsheet te exporteren, selecteert u de kettingvariabele voor de URL van de spreadsheet.
7. Klik op Opslaan en Publiceren.