Workiva kundestøttesenter

Ønsker du å koble deg til en tredjepartsapplikasjon utover Workivas forhåndsbygde Premium Connectors? Du kan oppnå dette ved å bruke HTTP Request Connector Commands 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 Connected Learning Path skal vi oppdatere kjeden vår til å bruke Runtime Inputs, der vi kan spesifisere hvilket regneark vi ønsker å hente.

Trinn 1: Kopier og modifiser en kjede

1. Gå til Chain Builder og finn frem til Chain CLP | HTTP Request List Spreadsheets.
2. Klikk på den vertikale ellipsen for å Copy kjeden.
3. Klikk på blyantikonet for å redigere kjeden.
4. Klikk på Chain Settings øverst til høyre, og gi kjeden et nytt navn: CLP | HTTP-forespørsel Hent et enkelt regneark.
5. (Valgfritt) Skriv inn en Beskrivelse: "Denne kjeden genererer et nytt Workiva API Access Token. Du må oppgi en gyldig klient-ID og klienthemmelighet fra en tidligere generert API-bevilgning i variabelverdiene nedenfor. Når kjeden kjøres, blir brukeren bedt om å oppgi en regneark-ID. Kjeden vil hente regnearket."
6. Lagre kjeden.

Trinn 2: Inndata ved kjøretid

Bruk Runtime Inputs Chain Event for å starte kjeden.
Her kan vi angi regneark-ID-en til regnearket vi ønsker å hente. Les mer om Runtime Inputs.

1. Flytt POST - Hent en token -kommando fra startnoden.
2. Legg til en Runtime Inputs Chain Event fra Chain Trigger Events til Start Node.
3. Dobbeltklikk på koblingen som knytter Runtime Inputs til kommandoen Get - List Spreadsheets, og slett koblingen.
4. Koble Runtime Inputs til POST - Hent et token Kommando.

5. Koble POST - Hent et token Kommando til GET - List Spreadsheets Kommando.

   

6. Dobbeltklikk på Runtime Inputs Chain Event for å konfigurere den.
7. Klikk på Add Input og konfigurer følgende felt:
   • Type: Tekstfelt
   • Vis navn: Regneark-ID - se dette dokumentet for å få hjelp til å finne ID-en
   • Påkrevd: Merk av i denne avmerkingsboksen
8. (Valgfritt) Skriv inn en Beskrivelse: "Med denne kommandoen kan brukeren angi verdier for nødvendige kjøretidsinndata."
9. Lagre kommandoen.

Trinn 3: Oppdater Get-kommandoen

Vi vil oppdatere HTTP Request Get-kommandoen slik at den gir oss informasjon om ett enkelt regneark i stedet for å liste opp alle regnearkene i arbeidsområdet.

1. Dobbeltklikk på kommandoen Get - List of Spreadsheets for å konfigurere den.
   1. Gi kommandoen et navn: Get - Hent et enkelt regneark.

   2. Bruk variabelen Spreadsheet ID fra Runtime Inputs i URL-feltet for å angi hvilket regneark som skal hentes.
      Dette gjør du ved å klikke på URL -feltet, og etter /regneark legger du til "/<Regneark-ID>",
      og erstatter <Regneark-ID> med variabelen fra Runtime Inputs på følgende måte:

      

      1. Utvid rullegardinmenyen Trigger i panelet til venstre.
      2. Utvid rullegardinmenyen Runtime Inputs.
      3. Velg variabelen Spreadsheet ID.

2. (Valgfritt) Skriv inn en Beskrivelse: "Denne kommandoen returnerer et enkelt regneark. For mer informasjon, se utviklerdokumentasjonen på https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/"
3. Lagre kommandoen.

Trinn 4: Test øvelsen

Nå som kjeden er ferdig, kan vi teste resultatet.

1. Publiser the Chain.
2. Klikk på Execute, og deretter på Run with Inputs.
3. Finn et Regneark-ID, ved å navigere til et regneark i Workiva-plattformen. Sørg for at brukeren har tillatelse til å bruke dette regnearket.
4. Klikk på Start.
5. Når kjeden er ferdig kjørt, kan du se at regnearkopplysningene er generert under fanen Outputs - Response Body i kommandoen 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).