Benutzerdefinierte Connectors

Während Azure Logic Apps, Microsoft Power Automate und Microsoft Power Apps über 325+ Konnektoren zur Verbindung mit Microsoft- und Nicht-Microsoft-Diensten bieten, möchten Sie vielleicht mit Diensten kommunizieren, die nicht als vorgefertigte Konnektoren verfügbar sind. Angepasste Konnektoren adressieren dieses Szenario, indem sie es Ihnen erlauben, einen Konnektor mit eigenen Auslösern und Aktionen zu erstellen (und sogar gemeinsam zu nutzen).

custom connectors - overview

Anmeldung

custom connectors - lifecycle

1. Erstellen Sie Ihre API

Ein benutzerdefinierter Konnektor ist ein Wrapper um eine REST-API (Logic Apps unterstützt auch SOAP-APIs), der es Logic Apps, Power Automate oder Power Apps, ermöglicht, mit dieser REST- oder SOAP-API zu kommunizieren. Diese APIs können es sein:

  • Öffentlich (sichtbar im öffentlichen Internet) wie Spotify, Slack, Rackspace, oder eine von Ihnen verwaltete API.
  • Privat (nur für Ihr Netzwerk sichtbar).

Für öffentliche APIs, die Sie erstellen und verwalten möchten, sollten Sie die Verwendung eines dieser Microsoft Azure-Produkte in Betracht ziehen:

Für private APIs bietet Microsoft eine lokale Datenkonnektivität über ein on-premises Daten-Gateway an.

2. Sichern Sie Ihre API

Verwenden Sie eine dieser Standardauthentifizierungsmethoden für Ihre APIs und Konnektoren (Azure Active Directory wird empfohlen):

Sie können eine Azure AD-Authentifizierung für Ihre API im Azure-Portal festlegen, sodass Sie keine Implementierung der Authentifizierung vornehmen müssen. Oder Sie können die Authentifizierung im Code Ihrer API verlangen und erzwingen. Weitere Informationen zu Azure AD für benutzerdefinierte Konnektoren finden Sie unter Sichern von APIs und Konnektoren mithilfe von Azure AD.

3. Beschreiben Sie die API und definieren Sie den benutzerdefinierten Konnektor

Sobald Sie über eine API mit authentifiziertem Zugriff verfügen, müssen Sie als Nächstes Ihre API beschreiben, damit Logic Apps, Power Automate oder Power Apps, mit Ihrer API kommunizieren können. Die folgenden Ansätze werden unterstützt:

OpenAPI-Definitionen und Postmann-Sammlungen verwenden unterschiedliche Formate, aber beide sind sprachunabhängige, maschinenlesbare Dokumente, die Ihre API beschreiben. Sie können diese Dokumente aus verschiedenen Tools generieren, die auf der von Ihrer API verwendeten Sprache und Plattform basieren. Hinter den Kulissen verwenden Logic Apps, Power Automate und Power Apps OpenAPI, um Konnektoren zu definieren.

4. Verwenden Sie Ihren Konnektor in einer Logic App, Power Automate oder Power Apps Anwendung

Angepasste Konnektoren werden auf die gleiche Weise wie von Microsoft verwaltete Konnektoren verwendet. Sie müssen eine Verbindung zu Ihrer API erstellen, um diese Verbindung zu verwenden, um alle Vorgänge aufzurufen, die Sie in Ihrem angepassten Konnektor freigelegt haben.

Konnektoren, die in Power Automate erstellt wurden, sind in Power Apps verfügbar. In Power Apps erstellte Konnektoren sind ebenso in Power Automate verfügbar. Dies gilt nicht für Konnektoren, die in Logic Apps erstellt wurden. Sie können jedoch die OpenAPI-Definition oder die Postman-Sammlung wiederverwenden, um den Konnektor in einem dieser Dienste neu zu erstellen. Weitere Informationen finden Sie im entsprechenden Tutorial:

5. Teilen Sie Ihren Konnektor

Sie können Ihren Konnektor für Benutzer in Ihrer Organisation auf die gleiche Weise freigeben, wie Sie Ressourcen in Logic Apps, Power Automate oder Power Apps freigeben. Die gemeinsame Nutzung ist optional, aber möglicherweise gibt es Szenarien, in denen Sie Ihre Konnektoren für andere Benutzer freigeben möchten.

Weitere Informationen finden Sie unter Benutzerdefinierte Konnektoren in Ihrer Organisation gemeinsam nutzen.

6. Zertifizieren Sie Ihren Konnektor

Wenn Sie Ihren Konnektor für alle Benutzer von Logic Apps Power Automate und Power Apps freigeben möchten, können Sie Ihren Konnektor zur Microsoft-Zertifizierung einreichen. Microsoft wird Ihren Konnektor überprüfen, auf technische und inhaltliche Konformität prüfen und die Funktionalität validieren.

Weitere Informationen finden Sie unter Senden Sie Ihre Konnektoren für die Microsoft-Zertifizierung ein.

Tutorial

Das Lernprogramm verwendet die Cognitive Services Text Analytics API. Microsoft stellt bereits einen Konnektor für diese API zur Verfügung. Er ist ein gutes Beispiel, um den Lebenszyklus von angepassten Konnektoren zu lehren und wie angepasste Konnektoren einzigartige Szenarien unterstützen können.

Szenario

Der Konnektor, den Sie erstellen, stellt den Vorgang Text Analytics Sentiment zur Verfügung, der die Bewertung der Stimmung (0,000 bis 1,000) für die Texteingabe zurückgibt.

Anforderungen

  • Eines der folgenden Abonnements:

  • Grundlegendes Verständnis, wie man Logic Apps, Power Automate oder Power Apps Flows erstellt.

  • API-Schlüssel für die Cognitive Services Text Analytics API.

Einen API-Schlüssel erhalten

Die Textanalyse-API verwendet einen API-Schlüssel zur Authentifizierung von Benutzern. Wenn ein Benutzer eine Verbindung zur API über einen benutzerdefinierten Konnektor herstellt, gibt der Benutzer den Wert dieses Schlüssels an. So erhalten Sie einen API-Schlüssel:

Starten Sie das Tutorial

Fortgeschrittene Tutorials

Die folgenden Tutorials bieten mehr Details für spezifische benutzerdefinierte Konnektor-Szenarien: