Einen benutzerdefinierten Konnektor zertifizieren

Abgeschlossen

Um allen Benutzern in Logic Apps, Power Automate und Power Apps einen benutzerdefinierten Konnektor als zertifizierten Konnektor zur Verfügung zu stellen, senden Sie Ihren Konnektor an Microsoft zur Zertifizierung. Microsoft prüft den Konnektor und genehmigt ihn dann zur Veröffentlichung, wenn er alle Zertifizierungskriterien erfüllt. Nachdem der Konnektor veröffentlicht wurde, wird er auf der vollständigen Liste der öffentlich verfügbaren Konnektoren geführt.

In dieser Lerneinheit werden alle Schritte des Zertifizierungsprozesses dargestellt, einschließlich einiger übergeordneter Schritte. Dieselben Schritte gelten auch für spätere Updates, können jedoch je nach Umfang des Updates erheblich schneller ausgeführt werden.

Zertifizierungsprozessdiagramm mit Planungs‑, Entwicklungs‑, Open Source‑, Übermittlungs‑, Zertifizierungs‑, Test‑, Bereitstellungs‑ und Supportschritten

Planung

Die Planung, wenn Sie sich vorstellen, wie Ihr Konnektor aussehen wird, ist der erste Schritt im Zertifizierungsprozess. Für das Erstellen eines Konnektors, den andere verwenden, sollte eine gewisse Planung aufgewendet werden.

Einige wichtige Planungsfaktoren, die Sie berücksichtigen sollten, sind:

  • Identifizieren, welche Trigger und Aktionen anfänglich verfügbar sind Sie müssen nicht 100 Prozent Ihrer API abdecken, aber der anfängliche Satz von Triggern und Aktionen sollte ein nützlicher Satz sein. Wenn Sie zu stark auf das beschränken, was Sie in Ihrer ursprünglichen Version haben, werden Benutzer frustriert sein, dass die Funktionalität für gängige Szenarien fehlt. Erwägen Sie, einen oder mehrere Workflows zu schreiben oder zu skizzieren, die in Microsoft Power Automate erstellt werden können, indem Sie Ihren Konnektor verwenden. Dieser Ansatz kann Ihnen bei der Entscheidung helfen, welche APIs in den Konnektor aufgenommen werden sollen.

  • Bewerten Sie, welche Änderungen an der API erforderlich sein könnten, um Trigger zu unterstützen oder auf andere Weise die Bereitstellung eines benutzerfreundlichen Konnektors zu verbessern.

  • Überlegen Sie, wie die Authentifizierung gehandhabt wird und welche Anpassungen zwischen der aktuellen Authentifizierung Ihrer API und den unterstützten Funktionen benutzerdefinierter Konnektoren erforderlich sind.

  • Überlegen Sie, wie Benutzer, die den Konnektor verwenden möchten, einen Schlüssel erhalten, wenn Ihre API API-Schlüssel verwendet.

  • Überprüfen Sie die Vorlagen für Konnektorrichtlinien, um festzustellen, ob die Implementierung von Vorlagen die Benutzerfreundlichkeit Ihres Konnektors verbessern würde.

  • Überprüfen Sie die unterstützten OpenAPI-Erweiterungen auf Anwendbarkeit. Beispielsweise wird die Testverbindung üblicherweise von zertifizierten Konnektoren implementiert. Die Verwendung dynamischer Werterweiterungen kann auch hilfreich sein, wenn Sie Parameter mit Wertelisten zur Auswahl haben.

Für die Zertifizierung neuer Konnektoren müssen Sie nicht warten, bis Sie die Entwicklung des Konnektors abgeschlossen haben, um sich für die Zertifizierung zu registrieren. Weitere Informationen finden Sie unter Zertifizierungsverfahren. Erwarten Sie eine E-Mail von einem Microsoft-Vertreter, der Ihnen hilft, Ihren benutzerdefinierten Konnektor besser zu verstehen, Ihren Entwicklungsfortschritt zu erläutern und Sie durch den Zertifizierungsprozess zu führen.

Bei Aktualisierungen eines zertifizierten Konnektors besteht der wichtigste Teil der Planung darin, vorhandene Benutzer nicht zu beschädigen. Dieses Problem wird in einer späteren Lerneinheit ausführlicher erläutert.

Entwicklung

Der Hauptfokus im Entwicklungsschritt besteht darin, Ihre API und die Definition für Ihren benutzerdefinierten Konnektor zur Übermittlung vorzubereiten. Bevor Sie mit dem nächsten Schritt fortfahren, sollten Sie sicherstellen, dass Ihre benutzerdefinierte Konnektordefinition bereinigt ist und alle richtigen Namen enthält, die Sie veröffentlichen möchten.

Eine Open Source erstellen

Die Einführungseinheit enthielt einen allgemeinen Überblick über die Erstellung eines Open-Source-Konnektors. Sie werden den zertifizierten Konnektor in die Datei Zertifizierte Konnektoren verschieben. Stellen Sie vor dem Senden einer Pull-Anforderung sicher, dass Sie die folgenden Aufgaben ausführen:

  • Bearbeiten Sie Ihre Konnektor-Dateien, um die spezifischen erforderlichen Metadaten hinzuzufügen. Ihre Konnektordateien müssen bestimmte Metadaten enthalten, die den Konnektor und seinen Enddienst beschreiben.

  • Führen Sie den Befehl „paconn validate“ auf Ihrem heruntergeladenen Konnektor aus, und beheben Sie dann die Fehler.

Verwenden Sie den folgenden Befehl, um die Validierung auszuführen:

paconn validate --api-def [Location of apiDefinition.swagger.json]

Nachdem Sie die Validierung bestanden haben, können Sie Ihre Pull-Anfrage an die dev-Verzweigung des GitHub-Repository senden. Diese Aktion startet einen automatisierten Prozess, der eine erste Validierung Ihrer Pull-Anfrage durchführt und sicherstellt, dass Sie über eine ordnungsgemäße Beitragsvereinbarung verfügen. Wenn die automatische Validierung abgeschlossen ist, wird sie Microsoft zur ersten Überprüfung zugewiesen. Wenn Prüfer Probleme finden, die behoben werden müssen, geben sie Kommentare zur Pull-Anforderung ein, und es wird erwartet, dass Sie diese beheben und die Pull-Anforderung erneut senden. Wenn alles akzeptabel aussieht, wird Ihre Pull-Anfrage in das Repository eingefügt.

Übermittlung

Der nächste Schritt besteht darin, Ihren Konnektor zur Zertifizierung in ISV Studio einzureichen, nachdem Sie von Ihrem Microsoft-Kontakt dazu aufgefordert wurden. ISV Studio ist ein Portal zur Verwaltung des restlichen Zertifizierungsprozesses und bietet Ihnen den Zustand Ihres Konnektors nach dessen Bereitstellung.

Als Teil des Prozesses zur Einreichung bei ISV Studio zur Zertifizierung sollten Sie bereit sein, Folgendes bereitzustellen:

  • Informationen zum Testen des Konnektors, z. B. ein API-Schlüssel, andere Authentifizierungsdetails oder Details, die einem Tester bei der Verwendung des Konnektors helfen würden.

  • Eine Intro.md-Datei, die Informationen enthält, die in die öffentliche Dokumentation für den Konnektor aufgenommen werden sollen. Eine Vorlage finden Sie in der Dokumentation Übermittlung an ISV Studio.

Im Verlauf der Zertifizierung erhalten Sie Aktualisierungen im Portal und eine E-Mail vom Hauptkontakt. Wenn Probleme auftreten, wird von Ihnen erwartet, dass Sie diese beheben, bevor die Zertifizierung fortgesetzt wird. Nachdem der Konnektor die Zertifizierung bestanden hat, soll er zum Testen in der Region „Vorschau“ bereitgestellt werden.

Testen

Im Rahmen des Zertifizierungsprozesses wird Ihr Konnektor zum Testen in der Region „Vorschau“ bereitgestellt. Jetzt können Sie sicherstellen, dass der bereitgestellte Konnektor ordnungsgemäß funktioniert, bevor er in allen Regionen weltweit bereitgestellt wird. Stellen Sie sicher, dass Sie alle Funktionen Ihres Konnektors in Power Apps, Power Automate und Logic Apps testen.

Weitere Informationen finden Sie unter Anleitungen zum Testen Ihres Konnektors bei der Zertifizierung.

Bereitstellung

Nach Abschluss des Tests wird Ihr Konnektor in allen öffentlichen Regionen bereitgestellt. Dieser Prozess wird voraussichtlich sieben bis zehn Werktage dauern, da Microsoft in seinen Regionen auf der ganzen Welt schrittweise Bereitstellungen vornimmt. Sie erhalten Benachrichtigungen, wenn jede Region bereitgestellt wird.

Support

Nachdem Ihr Konnektor öffentlich freigegeben wurde, können Sie seine Leistung von ISV Studio aus überwachen. Stellen Sie sicher, dass Ihre Support-Mitarbeiter wissen, wie Ihr Konnektor mit Power Apps oder Power Automate verwendet werden kann, damit sie Benutzer unterstützen können, bei denen Probleme auftreten.