Dela via

Skapa HTTP-begäranden

  • Artikel

I Copilot Studio kan du utöka en handläggare funktioner genom att anropa externa REST-API:er med hjälp av HTTP-begärannoden . Detta anrop kan vara användbart när du behöver hämta data från ett externt system eller manipulera data i det systemet.

Förutsättningar

Använda noden för HTTP-begäran

  1. Välj Lägg till nod (+), öppna undermenyn Avancerat och välj Skicka HTTP-begäran.

    Skärmbild av alternativet skicka HTTP-begäran i den avancerade menyn.

  2. I rutan URL ange URL för den API-slutpunkt som ska anropas.

  3. Välj rätt begäran Metod från listrutan. Metoderna GET, POST, PATCH, PUT och DELETE stöds.

    Skärmbild av slutförd API-URL och listrutan metod

  4. Under Rubriker och brödtext i noden ska du välja knappen Redigera , som öppnar fönstret Egenskaper för HTTP-begäran.

  5. Du kan även lägga till en eller flera rubriker i HTTP-begäran. Välj knappen Lägg till för att lägga till respektive rubriks nyckel och värde.

    Skärmbild av listan med huvudnyckelpar för HTTP-nod.

  6. Som standard skickas inget innehåll i brödtexten i HTTP-begäran, men du kan ange innehåll i innehållet i brödtexten.

  7. Svar på noden Datatypen för svar från de tillgängliga alternativen.

    Du kan ge ett exempel på JSON-svar som du vanligtvis hittar i dokumentationen för det API du anropar. Detta genererar en Power Fx-variabel så att du kan använda den på andra ställen i redigeringsarbetsytan, med intellisense-stöd i Power Fx-redigeraren. Välj Från exempeldata och välj sedan Hämta schema från exempel-JSON. Klistra in exempelsvaret i redigeraren och välj Bekräfta.

    Skärmbild av Hämta schema från exempelredigeraren för JSON.

  8. Under Spara svar som väljer du var HTTP-begärans svar ska lagras, antingen skapar du en ny variabel eller markerar en befintlig.

Skicka innehåll i brödtexten för HTTP-begäran

  1. Under Rubriker och brödtext i noden ska du välja knappen Redigera , som öppnar fönstret Egenskaper för HTTP-begäran.

  2. Under Brödtext, välj lämplig innehållstyp. Som standard anges Brödtext till Inget innehåll, där inget innehåll ska finnas i denna begärans brödtext, vilket är det vanligaste innehållet i en GET-begäran. Om du vill lägga till innehåll i brödtexten väljer du bland ett av de tillgängliga alternativen.

    Skärmbild av listrutan med alternativ för innehåll

    • JSON-innehåll: JSON-innehåll kan du tillhandahålla ett JSON-objekt i begärans brödtexten. Objektet används ofta när du gör POST- eller PUT-begäranden. När du väljer det här alternativet kan du ange JSON-innehållet med en redigerare.

      Du kan också specificera ditt JSON-innehåll med Power Fx, så att du kan inkludera dynamiska värden och referensvariabler. Välj knappen Redigera JSON, väljFormel och ange sedan ett Power Fx-objekt (en befintlig JSON som konverterats till ett Power Fx-objekt åt dig), som konverteras till JSON när denna HTTP-begäran görs.

      Skärmbild av JSON-innehåll som markerats för innehållstyp.

    • Oformaterat innehåll: Med oformaterat innehåll kan du infoga en datasträng i brödtexten för förfrågan och den här strängen kan vara av valfri innehållstyp du anger. Råinnehåll anges med en Power Fx-formel, till exempel stränginnehållet som visas i följande exempel.

      Skärmbild av RAW-innehåll som markerats för innehållstyp.

Felhantering och tidsgräns

Noden HTTP-begäran har flera alternativ för hantering av situationer där denna HTTP-begäran kan misslyckas eller returnera ett fel.

Som standard "genererar funktionen ett fel". Det innebär att när en HTTP-begäran returnerar ett fel eller inte kan köras, handläggare stoppar åtgärden och utlöser Error systemämne och visar ett felmeddelande.

Du kan emellertid konfigurera felhanteringen till att inte utlösa systemämnet Fel. I stället fylls HTTP-statuskoden och eventuella felsvar i de variabler som du anger, vilket gör att du kan ange de här variablerna efter behov och ämnet kan fortsätta köras. Den här konfigurationen är användbar i scenarier där du vill att handläggare ska fortsätta åtgärden, även om en viss HTTP-begäran misslyckas.

Konfigurera felhanteringsbeteendet.

  1. Under Rubriker och brödtext i noden ska du välja knappen Redigera , som öppnar fönstret Egenskaper för HTTP-begäran.

  2. Välj önskat beteende i listrutan Felhantering.

  3. Om du väljer Fortsätt på fel konfigurerar du variablerna Statuskod och Brödtext för felsvar, antingen skapar du nya variabler eller markerar befintliga variabler i väljaren.

    Skärmbild på felhantering som konfigurerats för att fortsätta med fel med variabler som angetts för statuskod och brödtext för felsvar.

Om HTTP-begäran misslyckas i det här kodexemplet lagrar handläggare HTTP-statuskoden i variabeln Topic.StatusCode och den svar brödtexten i variabeln Topic.ErrorResponse . Handläggare fortsätter till nästa steg i ämne.

Variabeltypen Felsvar är Valfri. Du kan använda Parsa värdekod om du vill konvertera den här variabeln till en Power Fx-post.

Egenskapsfönstret innehåller också egenskapen Tidsgräns för begäran som godkänner ett värde i millisekunder. Standardvärdet är 30 sekunder, men du kan ändra det här värdet om det behövs.