Wilt u verbinding maken met een applicatie van derden die geen gebruikmaakt van de vooraf gebouwde Premium Connectors van Workiva? Dit kunt u bereiken door gebruik te maken van de HTTP Request Connector Commands om te communiceren met REST API's.
Opmerking: Hoewel dit is gelabeld als HTTP-verzoek, wordt HTTPS (beveiligde HTTP) ondersteund (en aanbevolen).
In dit Connected Learning Path gaan we onze keten bijwerken om gebruik te maken van runtime-inputs, waarmee we kunnen specificeren welke spreadsheet we willen ophalen.
| Belangrijkste zakelijke toepassing | Verbinding maken met systemen van derden |
| Hoofdleerdoel | Gebruik de HTTP Request Connector Commands van Workiva om te communiceren met REST API's van applicaties van derden, naast de vooraf gebouwde connectors. Update Chains zodat ze Runtime Inputs gebruiken om aan te geven welke spreadsheet moet worden gebruikt. |
| Leerdoel voor het voortgezet onderwijs | Runtime-invoer gebruiken |
| Voorwaarden |
Configureer de Workiva API Grant |
| Ondersteunend sjabloon | CLP | HTTP-verzoek: Haal één spreadsheet op |
Stap 1: Een keten kopiëren en aanpassen
- Ga naar Chain Builder en zoek de spreadsheets Chain CLP | HTTP Request List .
- Klik op de verticale ellips om de ketting te kopiëren .
- Klik op het potloodpictogram om de ketting te bewerken.
- Klik rechtsboven op Keteninstellingen en hernoem de keten naar: CLP | HTTP-verzoek om een enkel spreadsheet op te halen .
- ( Optioneel ) Voer een beschrijving in: "Deze keten genereert een nieuw Workiva API-toegangstoken." U dient een geldige Client ID en Client Secret uit een eerder gegenereerde API Grant in de onderstaande variabelewaarden op te geven. Wanneer de keten wordt uitgevoerd, wordt de gebruiker gevraagd een spreadsheet-ID in te voeren. De keten zal de spreadsheet ophalen.
- Red de ketting.
Stap 2: Runtime-invoer
Gebruik de Runtime Inputs Chain Event om de keten te starten.
Hiermee kunnen we de spreadsheet-ID specificeren van de spreadsheet die we willen ophalen. Lees meer over Runtime Inputs.
- Verplaats het POST - Retrieve a Token Command-commando van het startknooppunt af.
- Voeg een Runtime Inputs Chain Event van Chain Trigger Events toe aan het Start Node.
- Dubbelklik op de link die Runtime Inputs koppelt aan de Get-List Spreadsheets Command en verwijder de link.
- Koppel runtime-inputs aan de POST-opdracht om een token op te halen .
-
Koppel de POST-opdracht (Token ophalen ) aan de GET-opdracht (Spreadsheets weergeven ).
- Dubbelklik op de Runtime Inputs Chain Event om deze te configureren.
- Klik op 'Invoer toevoegen' en configureer de volgende velden:
- Type: Tekstveld
- Weergavenaam: Spreadsheet-ID - raadpleeg dit document voor hulp bij het vinden van de ID.
- Vereist: Vink dit selectievakje aan
- ( Optioneel ) Voer een beschrijving in: "Met deze opdracht kan de gebruiker waarden opgeven voor de vereiste runtime-inputs."
- Sla de opdracht op.
Stap 3: Update Get Command
We zullen de HTTP-aanvraag GET-opdracht aanpassen zodat deze ons de details van één specifieke spreadsheet geeft in plaats van een lijst van alle spreadsheets in de werkruimte.
- Dubbelklik op de opdracht 'Lijst met spreadsheets ophalen ' om deze te configureren.
- Geef de opdracht de naam: Get - Haal een enkel spreadsheet op .
-
Gebruik de variabele Spreadsheet ID uit Runtime Inputs in het URL-veld om aan te geven welke spreadsheet moet worden opgehaald.
Om dit te doen, klikt u op het URL- veld en voegt u na /spreadsheets "/ < Spreadsheet ID > " toe, ter
vervanging van <Spreadsheet ID> waarbij de variabele uit de runtime-invoer als volgt wordt gebruikt:- Klap in het linkerpaneel het vervolgkeuzemenu 'Trigger' uit.
- Klap het vervolgkeuzemenu 'Runtime Inputs' uit.
- Selecteer de variabele Spreadsheet-ID .
- ( Optioneel ) Voer een beschrijving in: "Deze opdracht retourneert één spreadsheet." Voor meer informatie kunt u de ontwikkelaarsdocumentatie raadplegen op https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html
- Sla de opdracht op.
Stap 4: Test de oefening
Nu de keten compleet is, kunnen we het resultaat testen.
- Publiceer de keten.
- Klik op Uitvoeren en vervolgens op Uitvoeren met invoer .
- Zoek een Spreadsheet-ID, door naar een spreadsheet in het Workiva-platform te navigeren. Zorg ervoor dat de gebruiker die de subsidie heeft ontvangen, toegang heeft tot dit spreadsheet.
- Klik op Start .
- Zodra de Chain zijn uitvoering heeft voltooid, kunt u zien dat de spreadsheetgegevens zijn gegenereerd in het tabblad Uitvoer - Reactiebody van de Get -opdracht.