Aangepaste connectors

  • Artikel
  • 4 minuten om te lezen

Hoewel Azure Logic Apps, Microsoft Power Automate en Microsoft Power Apps meer dan 325 connectors bieden waarmee u met services van Microsoft en derden verbinding kunt maken, wilt u mogelijk met services communiceren die niet beschikbaar zijn als vooraf gebouwde connectors. Aangepaste connectors helpen bij dit scenario, omdat u een connector kunt maken (en zelfs delen) met eigen triggers en acties.

custom connectors - overview

Levenscyclus

custom connectors - lifecycle

1. Bouw uw API

Een aangepaste connector is een wrapper rond een REST API (Logic Apps ondersteunt ook SOAP API's) waarmee Logic Apps, Power Automate of Power Apps kan communiceren met die REST- of SOAP-API. De volgende API's zijn beschikbaar:

  • Openbaar (zichtbaar op het openbare internet) zoals Spotify, Slack, Rackspace of een API die u beheert.
  • Privé (alleen zichtbaar in uw netwerk).

Overweeg een van deze Microsoft Azure-producten te gebruiken voor openbare API's die u wilt maken en beheren:

Voor privé-API's biedt Microsoft on-premises gegevensconnectiviteit via een on-premises gegevensgateway.

2. Beveilig uw API

Gebruik een van deze standaard verificatiemethoden voor uw API's en connectors (Azure Active Directory wordt aanbevolen):

U kunt Azure AD-verificatie voor uw API instellen in de Azure Portal, zodat u geen verificatie hoeft te implementeren. Of u kunt verificatie vereisen en afdwingen in de code van uw API. Zie Secure your API and connector with Azure AD (Uw API en connector beveiligen met Azure AD) voor meer informatie over Azure AD voor aangepaste connectors.

3. Beschrijf de API en definieer de aangepaste connector

Zodra u een API met geverifieerde toegang hebt, is het volgende dat u moet doen het beschrijven van uw API zodat Logic Apps, Power Automate of Power Apps kan communiceren met uw API. De volgende benaderingen worden ondersteund:

OpenAPI-definities en Postman-verzamelen hebben verschillende indelingen, maar zijn beide taalonafhankelijke, machineleesbare documenten waarin uw API wordt beschreven. U kunt deze documenten genereren vanuit verschillende hulpprogramma's, afhankelijk van de taal en het platform dat uw API gebruikt. Achter de schermen maken Logic Apps, Power Automate en Power Apps gebruik van OpenAPI om connectors te definiëren.

4. Gebruik uw connector in een Logic Apps-, Power Automate- of Power Apps-app

Aangepaste connectors worden op dezelfde manier gebruikt als een door Microsoft beheerde connector. U moet een verbinding maken met uw API om de verbinding te gebruiken om bewerkingen aan te roepen die u in uw aangepaste connector hebt gemaakt.

Connectors die zijn gemaakt in Power Automate zijn beschikbaar in Power Apps. Tevens zijn connectors die zijn gemaakt in Power Apps beschikbaar in Power Automate. Dit geldt niet voor connectors die zijn gemaakt in Logic Apps. U kunt de OpenAPI-definitie of Postman-verzameling echter opnieuw gebruiken om de connector in een van deze services opnieuw te maken. Voor meer informatie raadpleegt u de bijbehorende zelfstudie:

5. Deel uw connector

U kunt uw connector op dezelfde manier delen met gebruikers in uw organisatie als resources in Logic Apps, Power Automate of Power Apps. Delen is optioneel, maar u hebt mogelijk scenario's waarin u uw connectors met andere gebruikers wilt delen.

Zie Aangepaste connectors delen binnen uw organisatie voor meer informatie.

6. Certificeer uw connector

Als u uw connector wilt delen met alle gebruikers van Logic Apps, Power Automate en Power Apps, kunt u uw connector indienen voor Microsoft-certificering. Microsoft beoordeelt uw connector, controleert op technische naleving en inhoud en valideert de functionaliteit.

Zie Uw connectors indienen voor Microsoft-certificering voor meer informatie.

Zelfstudie

De zelfstudie maakt gebruik van de Cognitive Services Text Analytics API. Microsoft biedt al een connector voor deze API. Het is een goed voorbeeld voor het aanleren van de levenscyclus van aangepaste connectors en hoe aangepaste connectors unieke scenario's kunnen ondersteunen.

Scenario

De connector die u bouwt, maakt de bewerking Text Analytics Sentiment beschikbaar, die een gevoelsscore (0,000 tot 1,000) voor de tekstinvoer retourneert.

Vereisten

  • Gebruik een van de volgende abonnementen:

  • Basiskennis van het maken van Logic Apps, Power Automate-stromen of Power Apps.

  • API-sleutel voor de Cognitive Services Text Analytics-API.

Een API-sleutel opvragen

De Text Analytics API gebruikt een API sleutel om gebruikers te verifiëren. Wanneer een gebruiker een verbinding met de API maakt via een aangepaste connector, geeft de gebruiker de waarde van deze sleutel op. Een API-sleutel verkrijgen:

De zelfstudie starten

Geavanceerde zelfstudies

De volgende zelfstudies bieden meer details voor specifieke aangepaste connectorscenario's: