Del via

Send HTTP-forespørsler

  • Artikkel

I Copilot Studio kan du utvide egenskapene til en kopilot ved å kalle opp eksterne REST-API-er ved hjelp av noden HTTP-forespørsel. Dette kallet kan være nyttig når du har behov for å hente data fra et eksternt system eller redigere data på det systemet.

Forutsetning

Bruk noden HTTP-forespørsel

  1. Velg Legg til node (+), åpne undermenyen Avansert, og velg deretter Send HTTP-forespørsel.

    Skjermbilde av sende alternativet HTTP-forespørsels på den avanserte menyen.

  2. I boksen URL angir du URL for API-endepunktet du vil kalle opp.

  3. Velg aktuell Metode for forespørsel fra rullegardinlisten. Metodene GET, POST, PATCH, PUT og DELETE støttes.

    Skjermbilde av fullført URL-adresse for API og rullegardinmeny for metode

  4. Under Overskrifter og brødtekst på noden, velg Rediger-knappen, som åpner ruten Egenskaper for HTTP-forespørsel.

  5. Du kan eventuelt legge til ett eller flere overskrifter i HTTP-forespørselen. Velg Legg til-knappen for å legge til nøkkel og verdi for hver overskrift.

    Skjermbilde av listen over nøkkelverdipar for overskrifter for HTTP-node.

  6. Som standard sendes ikke innhold i brødteksten i HTTP-forespørselen, men du kan angi innhold i brødteksten.

  7. På noden velger du Svardatatype fra de tilgjengelige alternativene.

    Du kan angi et JSON-eksempelsvar, som du vanligvis finner i dokumentasjonen for API-en du kaller. Den genererer en Power Fx-variabel, slik at du kan bruke den andre steder i redigeringslerretet med IntelliSense-støtte i Power Fx-redigeringsprogrammet. Velg Fra eksempeldata, og velg deretter Hent skjema fra eksempel-JSON. Lim inn eksempelsvaret i redigeringsprogrammet, og velg Bekreft.

    Skjermbilde av Hent skjema fra JSON-eksempelredigeringsprogrammet.

  8. Under Lagre svar som velger du hvor du vil at HTTP-forespørselssvaret skal lagres, enten ved å opprette en ny variabel eller velge en eksisterende.

Send innhold i teksten for HTTP-forespørsel

  1. Under Overskrifter og brødtekst på noden, velg Rediger-knappen, som åpner ruten Egenskaper for HTTP-forespørsel.

  2. Under Brødtekst velger du riktig innholdstype. Som standard er Brødtekst angitt til Uten innhold, der det ikke må være innhold i forespørselsbrødteksten, som er mest vanlig brukt sammen med GET-forespørslen. Hvis du vil legge til innhold i brødteksten, velger du blant ett av de tilgjengelige alternativene.

    Skjermbilde av rullegardinmenyen for alternativer for brødtekst

    • JSON-innhold: JSON-innhold gjør det mulig å angi et JSON-objekt i forespørselsteksten. Dette objektet brukes ofte når du foretar POST- eller PUT-forespørsler. Når dette alternativet er valg, kan du angi JSON-innholdet ditt i et redigeringsprogram.

      Du kan også spesifisere JSON-innholdet ditt ved å bruke Power Fx, slik at du kan inkludere dynamiske verdier og referansevariabler. Velg Rediger JSON-knappen, velg Formela, og angi deretter et Power Fx-objekt (eksisterende JSON som er angitt, konverteres til et Power Fx-objekt for deg), som konverteres til JSON når HTTP-forespørselen foretas.

      Skjermbilde av JSON-innhold som er valgt for innholdstype.

    • Råinnhold: Råinnhold gjør det mulig å sette inn en datastreng i forespørselsteksten, og denne strengen kan være av en innholdstype du angir. Råinnhold angis ved hjelp av en Power Fx-formel, for eksempel strenginnholdet som vises i eksemplet nedenfor.

      Skjermbilde av RAW-innhold som er valgt for innholdstype.

Feilbehandling og tidsavbrudd

Noden HTTP-forespørsel har flere alternativer for håndtering av situasjoner der HTTP-forespørselen kan mislykkes eller returnere en feil.

Som standard utløser funksjonen en feil. Dette betyr at når en HTTP-forespørsel returnerer en feil eller ikke kan kjøres, stopper kopiloten operasjonen og utløser systememnet Feil, slik at en feilmelding vises.

Du kan imidlertid konfigurere feilhåndteringen slik at den ikke utløser systememnet Feil. I stedet fylles HTTP-statuskoden ut og eventuell svartekst for feil i variabler som du angir, slik at du kan spørre disse variablene etter behov, og emnet kan fortsette å kjøre. Denne konfigurasjonen er nyttig i scenarioer der du vil at kopiloten skal fortsette å fungere selv om en bestemt HTTP-forespørsel mislykkes.

Konfigurere virkemåten for feilhåndtering.

  1. Under Overskrifter og brødtekst på noden, velg Rediger-knappen, som åpner ruten Egenskaper for HTTP-forespørsel.

  2. Velg ønsket virkemåte fra rullegardinlisten Feilhåndtering.

  3. Hvis du velger Fortsett ved feil, konfigurerer du variablene Statuskode og Feil svartekst, enten ved å opprette nye variabler eller velge eksisterende variabler fra velgeren.

    Skjermbilde av feilhåndtering konfigurert til å fortsette ved feil med variabler angitt for statuskode og feilsvartekst.

Hvis HTTP-forespørselen mislykkes i dette kodeekseplet, lagrer kopiloten HTTP-statuskoden i variabelen Topic.StatusCode og svarteksten i variabelen Topic.ErrorResponse. Kopiloten går deretter videre til de neste trinnene i emnet.

Feilsvar-variabeltypen er Alle. Du kan bruke Analyser verdi-noden til å konvertere denne variabele til en Power Fx-oppføring.

Egenskapsruten inneholder også en Request timeout-egenskap, som godtar en verdi i millisekunder. Standardverdien er 30 sekunder, men du kan endre denne verdien om nødvendig.