Workiva supportcenter

Vill du ansluta till en tredjepartsapplikation utöver Workivas förbyggda Premium Connectors? Du kan uppnå detta genom att använda HTTP Request Connector Commands för att interagera med REST API:er. 

Obs: Även om detta är märkt som en HTTP-förfrågan stöds (och rekommenderas) HTTPS (Secure HTTP).

I denna Connected Learning Path kommer vi att uppdatera vår Chain så att vi använder Runtime Inputs där vi kan ange vilket kalkylblad vi vill hämta.

Steg 1: Kopiera och modifiera en kedja

1. Navigera till Chain Builder och leta reda på kedjan CLP | HTTP Request List Spreadsheets.
2. Klicka på den vertikala ellipsen för att Copy kedjan.
3. Klicka på pennikonen för att redigera kedjan.
4. Klicka på Chain Settings längst upp till höger och byt namn på kedjan: CLP | HTTP-begäran Hämta ett enda kalkylblad.
5. (Valfritt) Ange en Beskrivning: "Denna kedja genererar en ny Workiva API Access Token. Du måste ange ett giltigt klient-ID och en giltig klienthemlighet från ett tidigare genererat API Grant i variabelvärdena nedan. När kedjan körs kommer användaren att uppmanas att ange ett kalkylblads-ID. Kedjan kommer att hämta kalkylbladet."
6. Spara kedjan.

Steg 2: Inmatningar för exekvering

Använd Runtime Inputs Chain Event för att starta kedjan.
Detta gör det möjligt för oss att ange kalkylbladets ID för det kalkylblad vi vill hämta. Läs mer om Runtime Inputs.

1. Flytta POST - Retrieve a Token Kommando från startnoden.
2. Lägg till en Runtime Inputs Chain Event från Chain Trigger Events till startnoden.
3. Dubbelklicka på länken som ansluter Runtime Inputs till Get - List Spreadsheets Command och radera länken.
4. Anslut Runtime Inputs till POST - Hämta en Token Kommando.

5. Anslut POST - Hämta en token Kommando till GET - Lista kalkylblad Kommando.

   

6. Dubbelklicka på Runtime Inputs Chain Event för att konfigurera den.
7. Klicka på Add Input och konfigurera följande fält:
   • Typ av fält: Textfält
   • Visa namn: Kalkylbladets ID - kolla in detta dokument för hjälp med att hitta ID
   • Obligatoriskt: Markera denna kryssruta
8. (Valfritt) Ange en Beskrivning: "Detta kommando gör det möjligt för användaren att ange värden för nödvändiga körtidsinmatningar."
9. Spara kommandot.

Steg 3: Uppdatera Get Command

Vi kommer att uppdatera HTTP Request Get Command för att ge oss detaljer om ett enda kalkylblad istället för att lista alla kalkylblad i arbetsytan.

1. Dubbelklicka på kommandot Get - List of Spreadsheets för att konfigurera det.
   1. Namnge kommandot: Get - Hämta ett enda kalkylblad.

   2. Använd variabeln Spreadsheet ID från Runtime Inputs i URL-fältet för att ange vilket kalkylblad som ska hämtas.
      Detta gör du genom att klicka på fältet URL och efter /spreadsheets lägga till "/<Kalkylblads-ID>",
      ersätta <Kalkylblads-ID> med variabeln från Runtime Inputs enligt följande:

      

      1. I den vänstra panelen expanderar du rullgardinsmenyn Trigger.
      2. Expandera rullgardinsmenyn Runtime Inputs.
      3. Välj variabeln Spreadsheet ID.

2. (Valfritt) Ange en Beskrivning: "Detta kommando returnerar ett enda kalkylblad. Mer information finns i dokumentationen för utvecklare på https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/"
3. Spara kommandot.

Steg 4: Testa övningen

Nu när kedjan är klar kan vi testa resultatet.

1. Publicera kedjan.
2. Klicka på Execute, och sedan på Run with Inputs.
3. Hitta ett kalkylblad ID, genom att navigera till ett kalkylblad i Workiva Platform. Kontrollera att användaren har behörighet till detta kalkylblad.
4. Klicka på Starta.
5. När kedjan har körts färdigt kan du se att kalkylbladsuppgifterna har genererats på fliken Outputs - Response Body i kommandot Get.

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