Einführung
Sie können einen benutzerdefinierten Open-Source-Konnektor erstellen und zertifizieren, um ihn allen Benutzern leicht zugänglich zu machen. Indem Sie es zu Open Source machen, stellen Sie sicher, dass Ihr Konnektor zum Microsoft Power Platform-GitHub-Repository veröffentlicht wird. Aus dem Repository kann jeder Benutzer Ihre benutzerdefinierte Konnektordefinition in eine Umgebung importieren und dann verwenden oder Beiträge zu Ihrem Konnektor machen, damit Sie die Übernahme in Betracht ziehen können. Wenn Sie einen benutzerdefinierten Konnektor erstellen, steht dieser nur Ihnen und den Benutzern zur Verfügung, für die Sie den Konnektor explizit freigeben. Damit ein Konnektor in der Liste der offiziellen Konnektoren für jeden Benutzer von Microsoft Power Automate, Microsoft Power Apps oder Microsoft Azure Logic Apps sichtbar ist, muss er zertifiziert sein.
Wann ein benutzerdefinierter Konnektor zertifiziert werden soll
Es gibt viele Gründe für die Zertifizierung Ihres benutzerdefinierten Konnektors, aber Benutzerfreundlichkeit, Sichtbarkeit und Erweiterung der Reichweite Ihrer API gehören zu den Hauptgründen. Zertifizieren Sie Ihren benutzerdefinierten Konnektor, wenn er Zugriff auf eine API bietet, die für eine breite Zielgruppe nützlich und nicht intern ausgerichtet ist. Sie müssen den zugrunde liegenden API-Dienst nicht auf Microsoft-Technologien hosten. In der Tat sind Konnektoren für die Integration von Microsoft Power Platform-Lösungen mit Nicht-Microsoft-Lösungen von Vorteil. Sie können Konnektoren kostenlos oder mit kostenpflichtigen APIs zertifizieren.
Zertifizierte Konnektoren werden überprüft, um sicherzustellen, dass sie den Kriterien für die Zertifizierung vor der Veröffentlichung entsprechen. Es gibt zwei Arten von verifizierten und unabhängigen Konnektor-Herausgebern.
Verifizierte Herausgeber – Eine wichtige Voraussetzung ist, dass Sie den zugrunde liegenden Service besitzen oder explizite Rechte zur Verwendung der API vorlegen und dann ein Benutzerszenario bereitstellen, das gut zu den Produkten passt.
Unabhängige Herausgeber – Besitzt nicht den zugrunde liegenden Dienst hinter ihrem Konnektor. Beispielsweise kann ein Benutzer einer API, der nicht mit dem Unternehmen verbunden ist, einen Konnektor für die API zur Zertifizierung einreichen. Dieser Typ ermöglicht es den Mitgliedern der Community, am Power Platform-Konnektor-Ökosystem teilzunehmen.
Die Erstzertifizierung und Aktualisierungen des Konnektors sind kostenlos. In der nächsten Lerneinheit wird der Zertifizierungsprozess näher erläutert.
Wann wird ein benutzerdefinierter Open-Source-Konnektor erstellt?
Jeder benutzerdefinierte Konnektor, den Sie erstellen, ist ein Kandidat dafür, Open Source zu werden, wenn Sie feststellen, dass andere davon profitieren könnten. Wenn Sie einen Konnektor zertifizieren, besteht Ihr erster Schritt darin, die Definition als Open Source festzulegen. Überprüfen Sie zunächst, ob im Repository für die von Ihnen erstellte API eine vorhandene benutzerdefinierte Konnektordefinition vorhanden ist. Wenn Sie eine Definition finden, empfehlen wir, dass Sie Ihre Änderungen einbringen, um diese zu verbessern, indem Sie eine Pull-Anforderung senden, anstatt zu versuchen, einen doppelten Konnektor zu erstellen.
Im Folgenden finden Sie Beispiele dafür, wann das Erstellen eines benutzerdefinierten Open Source-Konnektors am besten und am wenigsten optimal ist.
| Optimaler Open-Source-Kandidat | Schlechter Open-Source-Kandidat |
|---|---|
| Konnektor für eine API, die für jedermann öffentlich verfügbar ist | Konnektor für eine private API, die nur in Ihrem Unternehmensnetzwerk verfügbar ist |
Für die meisten Beiträge müssen Sie einem Lizenzvertrag für Mitwirkende (CLA) zustimmen, in der erklärt wird, dass Sie das Recht haben und tatsächlich die Rechte zur Nutzung Ihres Beitrags gewähren. Weitere Informationen finden Sie unter Lizenzvertrag für Mitwirkende.
Das GitHub-Repository verfügt über drei Hauptordner, die die Konnektoren enthalten: custom-connectors, independent-publisher-connectors und certified-connectors.
Der Ordner Benutzerdefinierte Konnektoren enthält voll funktionsfähige Konnektorbeispiele, auf denen bereitgestellt Microsoft Power Platform zur Erweiterung und Verwendung werden kann. Diese Beispiele sind möglicherweise keine zertifizierten Konnektoren, werden jedoch von der Open-Source-Community erstellt und verwaltet, um nützliche Szenarien oder Beispiele für Konnektorkonzepte anzubieten.
Der Ordner independent-publisher-Connectors enthält Konnektoren, die von Herausgebern übermittelt werden, die nicht Eigentümer des zugrunde liegenden Dienstes hinter ihrem Konnektor sind. In der Power Platform werden diese Konnektoren als Premium-Konnektoren bereitgestellt. Jeder kann einen neuen Konnektor an diesen Ordner senden, den Konnektoren in diesem Ordner Funktionen hinzufügen und Probleme im Zusammenhang mit den Konnektoren in diesem Ordner lösen. Der Ordner wird von der Konnektoren-Community unabhängiger Herausgeber verwaltet, zu der unabhängige Herausgeber und Projektkoordinatoren gehören. Der Master-Branch wird vom Microsoft-Konnektor-Zertifizierungsteam verwaltet, das sicherstellt, dass die Konnektorversion identisch ist mit der, die in der Power Platform bereitgestellt wurde. Die Verzweigung dev wird vom / von den Konnektorverwalter(n) und dem Microsoft-Konnektor-Zertifizierungsteam verwaltet, um die Community-Entwicklung des Konnektors vor der Zertifizierung und Bereitstellung einer Version zu ermöglichen.
Der Ordner Zertifizierte Konnektoren enthält zertifizierte Konnektoren, die bereits in Microsoft Power Platform bereitgestellt und sofort einsatzbereit sind. Eine Anforderung des Microsoft-Konnektor-Zertifizierungsprogramms besteht darin, dass neue zertifizierte Konnektoren Open Source für Community-Beiträge sein müssen. Das Microsoft-Konnektor-Zertifizierungsteam verwaltet den Ordner Zertifizierte Konnektoren, um sicherzustellen, dass innerhalb des Master-Branches die Konnektorversion identisch mit der ist, die in der Microsoft Power Platform bereitgestellt wird. Die Verzweigung dev wird vom Konnektorbesitzer und dem Microsoft-Konnektor-Zertifizierungsteam verwaltet, um die Community-Entwicklung des Konnektors vor der Zertifizierung und Bereitstellung einer Version zu ermöglichen.
Um zum GitHub-Repository beizutragen, erstellen Sie zunächst eine eigene Kopie (oder Eine Gabelung erstellen) des Repositorys. Die Schritte werden in der Eine Gabelung erstellen-Dokumentation erklärt. Nachdem Sie eine Gabelung erstellt haben, können Sie Ihren Konnektor mithilfe einer Pull-Anforderung für den Beitrag vorbereiten. Sie können Ihre Konnektoranlagen mithilfe der Microsoft Power Platform-Konnektor-CLI herunterladen.
Herunterladen mit Microsoft Power Platform-Konnektor-CLI
Verwenden Sie den Befehl paconn download von Microsoft Power Platform-Konnektoren-CLI, um die erforderlichen Dateien zum Erstellen eines Open-Source-Konnektors vorzubereiten.
Laden Sie die benutzerdefinierten Konnektordateien herunter, indem Sie den folgenden Befehl ausführen:
paconn download
Wenn Sie diesen Befehl ausführen, wird eine Geräteanmeldung durchgeführt, damit paconn in Ihrem Namen auf Ihre Microsoft Power Platform-Umgebung zugreifen kann. Nach der Authentifizierung erhalten Sie von paconn eine Liste mit Umgebungen, aus denen Sie auswählen können, gefolgt von einer Liste mit Konnektoren, aus denen Sie ebenfalls auswählen können.
Wenn Sie Ihre Umgebungs-ID und Konnektor-ID kennen, können Sie die folgende Befehlszeilensyntax verwenden, um nicht dazu aufgefordert zu werden:
paconn download -e [Microsoft Power Platform Environment GUID] -c [Connector ID]
Der Download enthält vier Dateien:
apiDefintion.swagger.json – OpenAPI-Definition für Ihren Konnektor, der beispielsweise alle Trigger und Aktionen enthält.
apiProperties.json – Definiert Richtlinienvorlagen und andere erweiterte Konnektoreigenschaften, die nicht Teil der OpenAPI-Spezifikationen sind.
icon.png – Ein kleines Symbol, das den Dienst im Designer darstellt, wenn der Konnektor verwendet wird.
settings.json – Wird verwendet, anstatt Parameter für paconn bereitzustellen.
Wenn Sie Ihren benutzerdefinierten Konnektor zu Open Source machen und ihn dann zertifizieren, erhalten Sie mehr Transparenz für Ihre API. Indem Sie die Konnektordefinition zum Open-Source-Repository beitragen, wird Ihr benutzerdefinierter Konnektor für andere Benutzer verfügbar. Wenn jemand einen zertifizierten Konnektor verwendet, verwendet er eine Definition, die automatisch aktualisiert wird, wenn Sie Aktualisierungen veröffentlichen. Bei Verwendung der Open-Source-Konnektordefinition müssen Benutzer Aktualisierungen auf ihre eigene Kopie anwenden. Im Rest dieses Moduls wird untersucht, wie Sie Ihren benutzerdefinierten Konnektor zertifizieren und seinen Lebenszyklus während der Entwicklung verwalten.