Workiva-ondersteuningscentrum

Wilt u verbinding maken met een toepassing van derden buiten de vooraf gebouwde Premium Connectors van Workiva? U kunt dit bereiken door gebruik te maken van de HTTP Request Connector Commands voor interactie met REST API's. 

Opmerking: Hoewel dit gelabeld is als HTTP Request, wordt HTTPS (Secure HTTP) ondersteund (en aanbevolen).

In dit Aangesloten Leerpad zullen we onze Keten bijwerken om Runtime Inputs te gebruiken, waar we kunnen specificeren welke spreadsheet we willen ophalen.

Stap 1: Een ketting kopiëren en wijzigen

1. Navigeer naar Chain Builder en zoek de Chain CLP | HTTP Request List Spreadsheets.
2. Klik op de verticale ellips op Kopieer de ketting.
3. Klik op het potloodpictogram om de ketting te bewerken.
4. Klik op Keteninstellingen rechtsboven, en hernoem de Keten: CLP | HTTP Request Get a Single Spreadsheet.
5. (Optioneel) Voer een Beschrijving: "Deze keten genereert een nieuw Workiva API Toegangstoken. U moet een geldige Client ID en Client Secret van een eerder gegenereerde API Grant in de onderstaande variabele waarden invullen. Wanneer de ketting wordt uitgevoerd, wordt de gebruiker gevraagd om een werkblad-ID in te voeren. De Ketting zal de Spreadsheet ophalen."
6. Sla de ketting op.

Stap 2: Runtime-ingangen

Gebruik de Runtime Inputs Chain Event om de Chain te starten.
Hiermee kunnen we de Spreadsheet-ID opgeven van de Spreadsheet die we willen verkrijgen. Lees meer over Runtime Inputs.

1. Verplaats het commando POST - Token ophalen van het Startknooppunt.
2. Voeg een Runtime Inputs Chain Event van Chain Trigger Events toe aan het Startknooppunt.
3. Dubbelklik op de koppeling die Runtime Inputs verbindt met de opdracht Get - List Spreadsheets en verwijder de koppeling.
4. Verbind Runtime-ingangen met de POST - Een token ophalen Opdracht.

5. Verbind de opdracht POST - Een token ophalen met de opdracht GET - Spreadsheets weergeven.

   

6. Dubbelklik op de Runtime Inputs Chain Event om deze te configureren.
7. Klik op Invoer toevoegen en configureer de volgende velden:
   • Type: Tekstveld
   • Weergavenaam: Spreadsheet ID - kijk op dit document voor hulp bij het vinden van de ID
   • Verplicht: Schakel dit selectievakje in
8. (Optioneel) Voer een Beschrijving: "Met deze opdracht kan de gebruiker waarden van vereiste runtime-invoer opgeven."
9. Opslaan de opdracht.

Stap 3: Get Command bijwerken

We zullen het HTTP Request Get Command bijwerken zodat het ons de details geeft over een enkele Spreadsheet in plaats van een lijst van alle Spreadsheets in de Workspace.

1. Dubbelklik op de opdracht Get - List of Spreadsheets om deze te configureren.
   1. Geef de opdracht een naam: Get - Een enkel spreadsheet ophalen.

   2. Gebruik de variabele Spreadsheet ID van Runtime Inputs in het URL-veld om aan te geven welke spreadsheet moet worden opgehaald.
      Om dit te doen, klikt u op het veld URL en voegt u na /spreadsheets "/< Spreadsheet ID >" toe,
      door <Spreadsheet ID> te vervangen door de variabele uit Runtime Inputs, en wel als volgt:

      

      1. Vouw in het linkerpaneel de vervolgkeuzelijst Trigger uit.
      2. Vouw de vervolgkeuzelijst Runtime Inputs uit.
      3. Selecteer de variabele Spreadsheet ID.

2. (Optioneel) Voer een Beschrijving: "Deze opdracht retourneert een enkele Spreadsheet. Raadpleeg voor meer informatie de documentatie voor ontwikkelaars op https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/".
3. Opslaan de opdracht.

Stap 4: De oefening testen

Nu de Chain compleet is, kunnen we het resultaat testen.

1. Publiceer de keten.
2. Klik op Execute en vervolgens op Run with Inputs.
3. Zoek een Spreadsheet ID, door te navigeren naar een Spreadsheet in het Workiva Platform. Zorg ervoor dat de gebruiker toestemming heeft om deze spreadsheet te gebruiken.
4. Klik op Start.
5. Zodra de Chain is uitgevoerd, kunt u zien dat de details van de spreadsheet zijn gegenereerd in het tabblad Outputs - Response Body van het Get commando.

To continue to challenge yourself and learn more about using the HTTP Request Connector to connect to a third party API, check out the next exercise CLP Copy a Spreadsheet (add link when document created).