Brugerdefinerede connectorer

  • Artikel
  • 4 minutter til læsning

Selvom Azure Logic Apps, Microsoft Power Automate og Microsoft Power Apps tilbyder mere end 325 connectorer, der kan oprette forbindelse til tjenester fra Microsoft og andre udbydere, kan du muligvis have behov for at kommunikere med tjenester, der ikke er tilgængelige som forhåndsdefinerede connectorer. Brugerdefinerede connectorer løser dette scenarie ved at gøre det muligt at oprette (og endda dele) en connector, der har egne udløsere og handlinger.

custom connectors - overview

Livscyklus

custom connectors - lifecycle

1. Byg din API

En brugerdefineret connector er en ombryder omkring en REST API (Logic Apps understøtter også SOAP-API'er), der gør det muligt for Logic Apps, Power Automate eller Power Apps at kommunikere med denne REST- eller SOAP-API. Disse API'er kan være:

  • Offentlige (synlige på det offentlige internet), f.eks. Spotify, Slack, Rackspace eller et API, du administrerer.
  • Private (kun synlige i dit netværk).

I forbindelse med offentlige API'er, du planlægger at oprette og administrere, kan du overveje at bruge et af disse Microsoft Azure-produkter:

Til private API'er tilbyder Microsoft lokal dataforbindelse via en datagateway i det lokale miljø.

2. Beskyt din API

Brug en af disse standardgodkendelsesmetoder til dine API'er og connectorer (Azure Active Directory anbefales):

Du kan konfigurere Azure AD-godkendelse for dit API i Azure-portalen, så du ikke behøver at implementere godkendelse. Du kan også kræve og gennemtvinge godkendelse i api'ens kode. Du kan finde flere oplysninger om Azure AD til brugerdefinerede connectorer under Beskyt API og connector med Azure AD.

3. Beskriv API'en, og definer den brugerdefinerede connector

Når du har et API med godkendt adgang, skal du beskrive API'en, så Logic Apps, Power Automate eller Power Apps kan kommunikere med dit API. Følgende metoder understøttes:

OpenAPI-definitioner og Postman-samlinger bruger forskellige formater, men begge er sprogagnostiske maskinlæsbare dokumenter, der beskriver din API. Du kan generere disse dokumenter ud fra forskellige værktøjer baseret på det sprog og den platform, der bruges af din API. Bag kulisserne bruger Logic Apps, Power Automate og Power Apps OpenAPI til at definere connectorer.

4. Brug din connector i en Logic Apps-, Power Automate- eller Power Apps-app

Brugerdefinerede connectorer, der bruges på samme måde, som Microsoft-administrerede connectorer bruges. Du skal oprette en forbindelse til din API for at bruge denne forbindelse til at få kontakt til de handlinger, du har fremvist i den brugerdefinerede connector.

Connectorer oprettet i Power Automate er tilgængelige i Power Apps. Connectorer oprettet i Power Apps er ligeledes tilgængelige i Power Automate. Dette gælder ikke for connectorer, der er oprettet i logic Apps. Du kan dog genbruge OpenAPI-definitionen eller Postman Collection for at genoprette forbindelsen i en af disse tjenester. Du kan finde flere oplysninger i det relevante selvstudium:

5. Del din connector

Du kan dele din forbindelse med brugere i organisationen på samme måde, som du deler ressourcer i Power Automate Logic Apps eller Power Apps. Deling er valgfri, men du kan have scenarier, hvor du vil dele dine connectorer med andre brugere.

Du kan finde flere oplysninger under Del en brugerdefineret connector i din organisation.

6. Certificer din connector

Hvis du vil dele din connector med alle brugere af Logic Apps, Power Automate og Power Apps, kan du indsende din connector til Microsoft-certificering. Microsoft undersøger din connector, kontrollerer, om den overholder angivne standarder for teknik og indhold og validerer funktionaliteten.

Du kan finde flere oplysninger under Indsende dine connectorer til Microsoft-certificering.

Selvstudium

Selvstudiet bruger Cognitive Services-Tekstanalyse-API. Microsoft har allerede en connector til denne API. Det er et godt eksempel på, hvordan den brugerdefinerede connectorer livscyklus ændres, og hvordan brugerdefinerede forbindelser kan understøtte entydige scenarier.

Scenarie

Den connector, du opretter, fremviser handlingen Tekstanalyse-synspunkt, der returnerer synspunktsscoren (0,000 til 1,000) for tekstinputtet.

Forudsætninger

  • Et af følgende abonnementer:

  • Grundlæggende forståelse af, hvordan du kan oprette Logic Apps, Power Automate-flows eller Power Apps.

  • API-nøgle til Tekstanalyse-API'en for Cognitive Services.

Hent en API-nøgle

I Tekstanalyse-API'en bruges en API-nøgle til at godkende brugere. Når en bruger opretter en forbindelse til API'et via en brugerdefineret connector, angiver brugeren værdien af denne nøgle. Sådan får du en API-nøgle:

  • Anmod om en API-nøgle for at afprøve API'en. Det kræver ikke et Azure-abonnement.

  • Føj tekstanalyse-API'en til dit Azure-abonnement. Når du har API-ressourcen i dit-abonnement, skal du hente API-nøglen fra sektionen Nøgler:

    Hent API-nøgle

Start selvstudiet

Avancerede selvstudier

Følgende selvstudier giver flere oplysninger i forbindelse med specifikke brugerdefinerede connector-scenarier: