Ønsker du å koble til en tredjepartsapplikasjon utover Workivas forhåndsbygde Premium Connectors? Du kan oppnå dette ved å bruke HTTP Request Connector-kommandoene til å samhandle med REST API-er.
Merk: Selv om dette er merket som HTTP-forespørsel, støttes (og anbefales) HTTPS (sikker HTTP).
I denne tilkoblede læringsstien vil vi oppdatere kjeden vår til å bruke kjøretidsinndata der vi kan spesifisere hvilket regneark vi ønsker å hente.
| Primær forretningsbrukstilfelle | Koble til tredjepartssystemer |
| Primært læringsmål | Bruk Workivas HTTP Request Connector-kommandoer til å samhandle med REST API-er for tredjepartsapplikasjoner utover de forhåndsbygde koblingene. Oppdater kjeder for å bruke kjøretidsinndata for å angi hvilket regneark som skal brukes. |
| Sekundært læringsmål | Bruk av kjøretidsinnganger |
| Forutsetninger |
Konfigurer Workiva API-tilskudd |
| Støttemal | CLP | HTTP-forespørsel Hent et enkelt regneark |
Trinn 1: Kopier og endre en kjede
- Naviger til Chain Builder og finn regnearkene for Chain CLP | HTTP-forespørselsliste .
- Klikk på den vertikale ellipsen for å kopiere kjeden.
- Klikk på blyantikonet for å redigere kjeden.
- Klikk på Kjedeinnstillinger øverst til høyre, og gi kjeden nytt navn: CLP | HTTP-forespørsel Hent et enkelt regneark .
- ( Valgfritt ) Skriv inn en beskrivelse : "Denne kjeden genererer et nytt Workiva API-tilgangstoken." Du må oppgi en gyldig klient-ID og klienthemmelighet fra et tidligere generert API-tildelingsdokument i variabelverdiene nedenfor. Når kjeden kjøres, vil den be brukeren om å oppgi en regneark-ID. Kjeden vil hente regnearket.
- Redd kjeden.
Trinn 2: Kjøretidsinnganger
Bruk Runtime Inputs Chain-hendelsen til å starte kjeden.
Dette lar oss spesifisere regnearks-ID-en til regnearket vi ønsker å hente. Les mer om kjøretidsinnganger.
- Flytt POST - Hent et token- kommandoen fra startnoden.
- Legg til en Runtime Inputs Chain Event fra Chain Trigger Events til startnoden.
- Dobbeltklikk på lenken som kobler Runtime Inputs til Get-List Spreadsheets -kommandoen, og slett lenken.
- Koble kjøretidsinnganger til POST - Hent en token- kommando.
-
Koble POST - Retrieve a Token- kommandoen til GET - List Spreadsheets- kommandoen.
- Dobbeltklikk på Runtime Inputs Chain-hendelsen for å konfigurere den.
- Klikk på Legg til inndata og konfigurer følgende felt:
- Type: Tekstfelt
- Visningsnavn: Regneark-ID – sjekk dette dokumentet for hjelp med å finne ID-en
- Obligatorisk: Merk av i denne avmerkingsboksen
- ( Valgfritt ) Skriv inn en beskrivelse : "Denne kommandoen lar brukeren angi verdier for nødvendige kjøretidsinndata."
- Lagre kommandoen.
Trinn 3: Oppdater Get-kommandoen
Vi oppdaterer HTTP Request Get-kommandoen for å gi oss detaljer om et enkelt regneark i stedet for å liste opp alle regnearkene i arbeidsområdet.
- Dobbeltklikk på kommandoen Get - List of Spreadsheets for å konfigurere den.
- Navngi kommandoen: Get - Hent et enkelt regneark .
-
Bruk regneark-ID- variabelen fra kjøretidsinndata i URL-feltet for å angi hvilket regneark som skal hentes.
For å gjøre dette, klikk på URL- feltet, og etter /spreadsheets legger du til "/ < Regneark-ID > ", erstatter
<Spreadsheet ID> med variabelen fra kjøretidsinndata som følger:- I venstre panel utvider du rullegardinmenyen Utløser.
- Utvid rullegardinmenyen Kjøretidsinnganger.
- Velg variabelen Regneark-ID .
- ( Valgfritt ) Skriv inn en beskrivelse : "Denne kommandoen returnerer et enkelt regneark. For mer informasjon, se utviklerdokumentasjonen på https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html
- Lagre kommandoen.
Trinn 4: Test øvelsen
Nå som kjeden er fullført, kan vi teste resultatet.
- Publiser kjeden.
- Klikk på Utfør , og deretter på Kjør med inndata .
- Finn en Regneark-ID, ved å navigere til et regneark i Workiva-plattformen. Sørg for at brukeren som gir tillatelse har tillatelse til dette regnearket.
- Klikk på Start .
- Når kjeden har fullført kjøringen, kan du se at regnearksdetaljene er generert i fanen Utdata – Svarinnhold for Get -kommandoen.