Workiva supportcenter

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

Obs: Även om detta är märkt som HTTP-begäran, stöds (och rekommenderas) HTTPS (Secure HTTP).

I den här anslutna lärvägen kommer vi att uppdatera vår kedja för att använda runtime-indata 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å kalkylbladen för Chain CLP | HTTP-förfrågningslista .
2. Klicka på den vertikala ellipsen för att kopiera kedjan.
3. Klicka på pennikonen för att redigera kedjan.
4. Klicka på Kedjeinställningar 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-åtkomsttoken." Du måste ange ett giltigt klient-ID och en klienthemlighet från ett tidigare genererat API-tillstånd i variabelvärdena nedan. När kedjan körs uppmanas användaren att ange ett kalkylblads-ID. Kedjan kommer att hämta kalkylarket.
6. Rädda kedjan.

Steg 2: Inmatningar för exekvering

Använd händelsen Runtime Inputs Chain för att starta kedjan.
Detta låter oss ange kalkylblads-ID:t för det kalkylblad vi vill hämta. Läs mer om körtidsingångar.

1. Flytta POST - Hämta en token -kommandot från startnoden.
2. Lägg till en Runtime Inputs Chain-händelse från Chain Trigger Events till startnoden.
3. Dubbelklicka på länken som kopplar samman Runtime Inputs med kommandot Get-List Spreadsheets och ta bort länken.
4. Anslut runtime-ingångar till POST - Hämta ett token- kommando.

5. Koppla POST-kommandot Retrieve a Token till GET-kommandot List Spreadsheets .

   

6. Dubbelklicka på händelsen Runtime Inputs Chain för att konfigurera den.
7. Klicka på Lägg till inmatning och konfigurera följande fält:
   • Typ: Textfält
   • Visningsnamn: Kalkylblads-ID – kolla in det här dokumentet för hjälp med att hitta ID:t
   • Obligatoriskt: Markera den här kryssrutan
8. ( Valfritt ) Ange en beskrivning : "Det här kommandot låter användaren ange värden för obligatoriska indata under körning."
9. Spara kommandot.

Steg 3: Uppdatera Get-kommandot

Vi kommer att uppdatera HTTP Request Get-kommandot för att ge oss information om ett enskilt 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: Hämta - Hämta ett enskilt kalkylblad .

   2. Använd variabeln Kalkylblads-ID från Runtime Inputs i URL-fältet för att ange vilket kalkylblad som ska hämtas.
      För att göra detta, klicka på URL- fältet och lägg till "/ < Kalkylblads-ID > " efter /spreadsheets , ersätter
      <Spreadsheet ID> med variabeln från körtidsingångarna enligt följande:

      

      1. I den vänstra panelen expanderar du rullgardinsmenyn Utlösare.
      2. Expandera rullgardinsmenyn Körtidsindata.
      3. Välj variabeln Kalkylblads-ID .

2. ( Valfritt ) Ange en beskrivning : "Det här kommandot returnerar ett enda kalkylblad. För mer information, se utvecklardokumentationen på https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html
3. Spara kommandot.

Steg 4: Testa övningen

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

1. Publicera kedjan.
2. Klicka på Kör och sedan på Kör med indata .
3. Hitta en Kalkylbladets IDgenom att navigera till ett kalkylblad i Workiva-plattformen. Se till att den beviljade användaren har behörighet till detta kalkylblad.
4. Klicka på Starta .
5. När kedjan har slutfört sin körning kan du se att kalkylbladsinformationen har genererats på fliken Utdata - Svarstext för Get -kommandot.