Övning – Skapa och anropa en anpassad anslutningsapp från ett arbetsflöde i Azure Logic Apps

Slutförd

Du har ett webb-API som heter Print Framer API, som beräknar en kostnad för en tavelram baserat på de mått som du skickar till det. Utvecklare i hela företaget vill använda det här API:et i sina Azure Logic Apps-arbetsflöden, men det finns för närvarande inget sätt att upprätta den anslutningen.

I den här övningen skapar du en anpassad anslutningsapp för Print Framer-API:et och använder den för att skicka och ta emot data från ett logikapparbetsflöde till ett webb-API. Först behöver vi ett arbetsflöde för logikappen.

Skapa ett arbetsflöde för logikappen

  1. I Menyn i Azure-portalen eller på sidan Start går du till Azure-tjänster och väljer Skapa en resurs. Fönstret Skapa en resurs visas.

  2. I det vänstra menyfönstret väljer du Integrering och letar sedan upp och väljer Logikapp.

  3. I fönstret Skapa logikapp under Grundläggande anger du följande värden för varje inställning.

    Inställning Värde
    Projektinformation
    Prenumeration Concierge-prenumeration
    Resursgrupp Välj resursgrupp för sandbox-miljö
    Instansinformation
    Namn på logikapp Ange ett unikt namn. Kom ihåg namnet för senare användning.
    Publicera Arbetsflöde
    Region Välj en region nära dig.
    Aktivera logganalys Nej
    Planera
    Abonnemangstyp Förbrukning
    Zonredundans
    Zonredundans Lämna som standard (inaktiverad)

    Med den kostnadsfria sandbox-miljön kan du skapa resurser i några av Azures globala regioner. Välj en region från följande lista när du skapar resurser:

    • Västra USA 2
    • USA, södra centrala
    • Central US
    • East US
    • Europa, västra
    • Sydostasien
    • Japan, östra
    • Brasilien, södra
    • Sydöstra Australien
    • Indien, centrala
  4. Välj Granska + skapa och välj sedan Skapa när valideringen har slutförts.

  5. När portalen har skapat logikappresursen väljer du Gå till resurs.

    Azure-portalen visar ett galleri med vanliga utlösare och arbetsflödesmönster.

  6. Välj Logikappdesigner på den vänstra menyn och välj sedan Lägg till en utlösare.

  7. Sök efter och välj När en HTTP-begäran tas emot.

    Arbetsflödesdesignern visar nu den utlösare som du har valt.

  8. Välj Visa alla i avsnittet Avancerade parametrar .

  9. Välj GET i listrutan Metod .

  10. Ange {height}/{width} som en literalsträng i fältet Relativ sökväg .

    Skärmbild som visar information om utlösaren för begäran.

  11. I verktygsfältet för designern väljer du Spara.

Nu har vi ett grundläggande arbetsflöde för logikappen. Nu ska vi lägga till en anpassad anslutningsapp så att vi kan anropa vårt anpassade Framer-API för utskrift från vårt arbetsflöde.

Skapa en ny anpassad Azure Logic Apps-anslutningsapp i Azure-portalen

  1. I Menyn i Azure-portalen eller på sidan Start går du till Azure-tjänster och väljer Skapa en resurs. Fönstret Skapa en resurs visas.

  2. I sökrutan letar du upp och väljer Logic Apps Custom Anslut or.

  3. I fönstret Anpassad Anslut eller för Logic Apps väljer du Skapa.

  4. I fönstret Skapa anpassad anslutningsapp för logikappar , under Grundläggande, anger du följande värden för varje inställning.

    Inställning Värde
    Projektinformation
    Prenumeration Concierge-prenumeration
    Resursgrupp Välj resursgrupp för sandbox-miljö
    Instansinformation
    Namn på anpassad anslutningsapp PrintFramerConnector
    Region Välj en region som är nära dig och som också stöds av sandbox-miljön.
    Associera med integrationstjänstmiljön Lämna avmarkerat
  5. Välj Granska + skapa. När valideringen har slutförts väljer du Skapa.

  6. När distributionen är klar väljer du Gå till resurs.

Importera OpenAPI-definitionen

Använd nu OpenAPI-filen som du sparade tidigare för att definiera den anpassade anslutningsappen.

  1. I Azure-portalen eller på sidan Start väljer du Alla resurser och sedan PrintFramer Anslut or.

  2. På sidan Översikt väljer du Redigera.

    Skärmbild som visar redigeraren för anpassad anslutningsapp.

  3. I avsnittet Anpassade anslutningsappar väljer du OpenAPI-fil och sedan Importera. Öppna JSON-filen som du sparade i den senaste övningen.

Konfigurera den anpassade anslutningsappen

OpenAPI-filen informerar den anpassade anslutningsappen om de åtgärder som finns tillgängliga i webb-API:et. Det finns några andra egenskaper som du måste ange för den anpassade anslutningsappen.

  1. I avsnittet Allmän information går du till rutan Beskrivning och anger Hämta en uppskattning för en bildram. Du kan behöva rulla ned för att se den här delen av konfigurationsfönstret.

  2. I textrutan Värd anger du den exempel-URL som du antecknade tidigare.

  3. I fönstret Säkerhet kontrollerar du att Ingen autentisering har valts.

    Viktigt!

    För den här demonstrationen går det bra att tillåta åtkomst till API:et utan autentisering. För verkliga API:er, som innehåller känsliga data eller kräver en betald prenumeration, är autentisering viktigt.

  4. I fönstret Definition i textrutan Sammanfattning anger du Beräkna kostnaden för en bildram.

  5. Under Synlighet väljer du Viktigt.

  6. Längst upp i fönstret väljer du Uppdatera anslutningsapp.

Lägga till den anpassade anslutningsappen i logikappens arbetsflöde

Nu kan du använda den anpassade anslutningsappen i logikappens arbetsflöde.

  1. I Azure-portalen eller på sidan Start väljer du Alla resurser under Azure-resurser och sedan den logikappresurs som du skapade i enhet 3.

  2. I resursmenyn för logikappen väljer du Översikt. I verktygsfältet Översikt väljer du Redigera.

  3. I designern väljer du Nytt steg>Lägg till en åtgärd.

  4. Under sökrutan Välj en åtgärd väljer du Anpassad och sedan PrintFramer Anslut or.

  5. Under Åtgärder väljer du Beräkna kostnaden för en bildram.

  6. I rutan Beräkna kostnaden för en bildram placerar du markören i fältet Höjd . Välj höjd i listan med dynamiskt innehåll som öppnas.

    Följande skärmbild visar det här valet:

    Skärmbild som visar den anpassade anslutningsappen och parametern

  7. Gå tillbaka till den anpassade anslutningsappen och placera markören i fältet Bredd . Välj bredd i listan med dynamiskt innehåll.

    De höjd- och breddparametrar som tas emot från varje HTTP-begäran som utlöser vårt arbetsflöde är nu bundna till de höjd- och breddparametrar som skickas till PrintFramer Anslut or.

Slutför arbetsflödet

Slutligen behöver arbetsflödet ett sätt att visa resultatet. Du kan använda åtgärden Svar för att visa uppskattningen:

  1. I arbetsflödesdesignern väljer du Nytt steg.

  2. I sökrutan Välj en åtgärd anger du Svar och väljer sedan åtgärden Med namnet Svar.

  3. I fältet Brödtext anger du Den ungefärliga kostnaden för din ram är:$.

  4. I listan med dynamiskt innehåll som öppnas väljer du Brödtext i avsnittet Beräkna kostnaden för en bildram .

    Följande skärmbild visar det här valet:

    Skärmbild som visar konfigurationen för åtgärden

  5. När du är klar väljer du Spara för att spara arbetsflödet.

Testa arbetsflödet

Arbetsflödet är nu klart och anropar webb-API:et med hjälp av den anpassade anslutningsappen. Nu behöver du bara skicka en begäran som utlöser arbetsflödet, vilket du kan göra med hjälp av webbläsaren.

  1. I arbetsflödesdesignern expanderar du åtgärden När en HTTP-begäran tas emot .

  2. Bredvid fältet HTTP GET URL (HTTP GET URL ) väljer du Kopiera URL.

  3. Öppna en ny webbläsarflik och klistra in URL:en i adressfältet.

  4. I den inklistrade URL:en ersätter du parametern {height} med 10. Ersätt parametern {width} med 4. Tryck på Retur.

    Webbläsarfönstret visar en ungefärlig kostnad.

  5. Prova att ange andra höjder och bredder.

Grattis! Du har skapat ett arbetsflöde för logikappen som kan anropa ditt interna Print Framer-API med hjälp av en anpassad anslutningsapp!