Freigeben über

Power Platform-Konnektor- und -Plug-In-Dateien für die Zertifizierung vorbereiten

  • Artikel

Dieser Prozess bezieht sich sowohl auf verifizierte als auch auf unabhängige Herausgeber.

Nachdem Sie die Entwicklung Ihres benutzerdefinierten Konnektors und/oder Plug-Ins abgeschlossen haben, folgen Sie diesen Schritten, um ihn/es für die Zertifizierung vorzubereiten und die Konnektor- und/oder Plug-In-Dateien zu generieren, die Sie an Microsoft senden.

Hinweis

Dieser Artikel enthält Informationen zum Zertifizieren benutzerdefinierter Connectors in Azure Logic Apps, Power Automate, Power Apps und Plug-Ins in Copilot. Bevor Sie die Schritte in diesem Artikel erledigen, lesen Sie Lassen Sie Ihren Konnektor und/oder ihr Plug-In zertifizieren.

Schritt 1: Ihren Connector und/oder Ihr Plug-In registrieren (gilt nur für unabhängige Herausgeber)

Dieser Abschnitt gilt nicht für verifizierte Herausgeber.

Eine Zertifizierung kann beantragt werden, auch wenn die Entwicklung Ihres benutzerdefinierten Konnektors und/oder Plug-Ins noch nicht abgeschlossen ist. Um den Zertifizierungsprozess zu beginnen, registrieren Sie Ihren Konnektor und/oder Ihr Plug-In zur Zertifizierung, indem Sie unser Registrierungsformular ausfüllen.

Erwarten Sie innerhalb von zwei Werktagen eine E-Mail von einem Microsoft-Kontakt, der:

  • Versteht Ihren benutzerdefinierten Connector, Connector und/oder Ihr Plug-In.
  • Sich über Ihren Entwicklungsfortschritt informiert.
  • Sie über den Zertifizierungsprozess per E-Mail informiert.

Schritt 2: Übermittlungsanforderungen für Connectors erfüllen

Um einen hohen Qualitäts- und Konsistenzstandard unter unseren zertifizierten Konnektoren aufrechtzuerhalten, hat Microsoft eine Reihe von Anforderungen und Richtlinien festgelegt, die Ihr benutzerdefinierter Konnektor für die Zertifizierung einhalten muss.

Geben Sie Ihrem Konnektor einen Titel

Der Titel muss die folgenden Anforderungen erfüllen.

  • Muss existieren und in englischer Sprache verfasst sein.
  • Muss eindeutig sein und sich von allen Titeln bestehender Konnektoren und/oder Plug-Ins unterscheiden lassen.
  • Sollte der Name Ihres Produktes oder Ihrer Organisation sein.
  • Sollte den bestehenden Namensmustern für zertifizierte Konnektoren und/oder Plug-Ins folgen. Bei unabhängigen Publishern sollte der Name des Connectors dem Muster Connector and/or plugin Name (Independent Publisher) folgen.
  • Darf nicht länger als 30 Zeichen sein.
  • Darf nicht die Wörter API, Konnektor oder einen unserer Power Platform-Produktnamen (z. B. Power Apps) enthalten.
  • Darf nicht mit einem nicht alphanumerischen Zeichen enden, einschließlich Wagenrücklauf, neue Zeile oder Leerzeichen.

Beispiele

  • Gute Connector- und/oder Plug-In-Titel: Azure Sentinel*, *Office 365 Outlook
  • Schlechte Connector- und/oder Plug-In-Titel: Azure Sentinel's Power Apps Connector, Office 365 Outlook API

Schreiben Sie eine Beschreibung für Ihren Konnektor

Die Beschreibung muss die folgenden Bedingungen erfüllen.

  • Muss existieren und in englischer Sprache verfasst sein.
  • Muss frei von grammatikalischen und Rechtschreibfehlern sein.
  • Sollte den Hauptzweck und den Wert, den Ihr Konnektor bietet, prägnant beschreiben.
  • Darf nicht kürzer als 30 Zeichen und nicht länger als 500 Zeichen sein.
  • Darf keine Power Platform-Produktnamen enthalten (z. B. „Power Apps“).

Entwerfen Sie ein Symbol für Ihren Connector (gilt nur für verifizierte Herausgeber)

Dieser Abschnitt gilt nicht für unabhängige Herausgeber.

  • Erstellen Sie ein Logo mit 1:1-Abmessungen im Bereich von 100 x 100 bis 230 x 230 Pixeln (keine abgerundeten Kanten).
  • Verwenden Sie einen nicht transparenten, nicht weißen (#ffffff) Hintergrund und nicht Standardfarbe (#007ee5), die der angegebenen Hintergrundfarbe des Symbols entspricht.
  • Stellen Sie sicher, dass das Symbol sich von allen anderen Symbolen für zertifizierte Konnektoren unterscheidet.
  • Senden Sie das Logo im PNG-Format als <icon>.png.
  • Stellen Sie die Logoabmessungen auf unter 70 % für die Höhe und Breite des Bildes mit einem einheitlichen Hintergrund ein.
  • Stellen Sie sicher, dass die Markenfarbe eine gültige Hexadezimalfarbe ist und nicht Weiß (#ffffff) oder Standard (#007ee5) sein sollte.

Definieren Sie Zusammenfassungen und Beschreibungen von Vorgängen und Parametern

Die Zusammenfassungen und Beschreibungen müssen die folgenden Bedingungen erfüllen.

  • Muss existieren und in englischer Sprache verfasst sein.
  • Muss frei von grammatikalischen und Rechtschreibfehlern sein.
  • Zusammenfassungen von Vorgängen und Parametern sollten Ausdrücke von 80 Zeichen oder kürzer sein und nur alphanumerische Zeichen oder Klammern enthalten.
  • Vorgangs- und Parameterbeschreibungen sollten vollständige, beschreibende Sätze sein und mit Satzzeichen enden.
  • Sie dürfen keinen der Microsoft Power Platform-Produktnamen enthalten (z. B. „Power Apps“).

Definieren Sie exakte Vorgangsantworten

Die Vorgangsantworten müssen die folgenden Bedingungen erfüllen.

  • Definieren Sie Operationsantworten mit einem genauen Schema nur mit erwarteten Antworten.
  • Verwenden Sie keine Standardantworten mit einer exakten Schemadefinition.
  • Geben Sie gültige Antwortschemadefinitionen für alle Operationen im Swagger an.
  • Leere Antwortschemata sind nicht zugelassen, außer in besonderen Fällen, in denen das Antwortschema dynamisch ist. Dies bedeutet, dass in der Ausgabe kein dynamischer Inhalt angezeigt wird und Ersteller JSON verwenden müssen, um die Antwort zu analysieren.
  • Leere Vorgänge sind nicht zugelassen.
  • Entfernen Sie leere Eigenschaften, sofern sie nicht erforderlich sind.

Überprüfen von Swagger-Eigenschaften

Die Eigenschaften müssen die folgenden Bedingungen erfüllen.

  • Stellen Sie sicher, dass die „openapidefinition“ in einer korrekt formatierten JSON-Datei vorliegt.
  • Stellen Sie sicher, dass die Swagger-Definition dem OpenAPI 2.0-Standard und dem erweiterten Standard der Konnektoren entspricht.

Verbindungsparameter überprüfen

Die Parameter müssen die folgenden Bedingungen erfüllen.

  • Stellen Sie sicher, dass die Eigenschaft mit den entsprechenden Werten für „UIDefinition“ (Anzeigename, Beschreibung) aktualisiert wird.

  • Wenn Ihr Verbindungsparameter die Standardauthentifizierung verwendet, stellen Sie sicher, dass JSON wie im folgenden Beispiel richtig formatiert ist.

    {
  "username": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourUsernameLabel",
      "description": "The description of YourUsernameLabel for this api",
      "tooltip": "Provide the YourUsernameLabel tooltip text",
      "constraints": {
        "tabIndex": 2,
        "clearText": true,
        "required": "true"
        }
  }
},
  "password": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourPasswordLabel",
      "description": "The description of YourPasswordLabel for this api",
      "tooltip": "Provide the YourPasswordLabel tooltip text",
      "constraints": {
        "tabIndex": 3,
        "clearText": false,
        "required": "true"
      }
    }
  }
}

  • Wenn Ihr Verbindungsparameter APIKey als Authentifizierung hat, stellen Sie sicher, dass JSON wie im folgenden Beispiel richtig formatiert ist.

    {
  "api_key": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourApiKeyParameterLabel",
      "tooltip": "Provide your YourApiKeyParameterLabel tooltip text",
      "constraints": {
        "tabIndex": 2,
        "clearText": false,
        "required": "true"
      }
    }
  }
}

  • Wenn Ihr Verbindungsparameter „Generisches OAuth“ als Authentifizierung hat, stellen Sie sicher, dass JSON wie im folgenden Beispiel richtig formatiert ist.

    {
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "oauth2",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {
        "AuthorizationUrl": {
          "value": "https://contoso.com"
        },
        "TokenUrl": {
          "value": "https://contoso.com"
        },
        "RefreshUrl": {
          "value": "https://contoso.com"
        }
      },
      "clientId": "YourClientID"
    },
    "uiDefinition": null
  }
}

  • Wenn Ihr Verbindungsparameter einen OAuth2-Identitätsanbieter hat, stellen Sie sicher, dass der Identitätsanbieter aus der Liste der unterstützten OAuth2-Anbieter stammt. Es folgt das Beispiel des GitHub OAuth2-Identitätsanbieters:

    {
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "github",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {},
      "clientId": "YourClientId"
    },
    "uiDefinition": null
  }
}

  • Wenn Ihr Verbindungsparameter Microsoft Entra ID als Authentifizierung hat, stellen Sie sicher, dass JSON wie im folgenden Beispiel richtig formatiert ist.

    {
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "aad",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {
        "LoginUri": {
          "value": "https://login.microsoftonline.com"
        },
        "TenantId": {
          "value": "common"
        },
        "ResourceUri": {
          "value": "resourceUri"
        },
        "EnableOnbehalfOfLogin": {
          "value": false
        }
      },
      "clientId": "AzureActiveDirectoryClientId"
    },
    "uiDefinition": null
  }
}

Erstellen Sie hochwertige englische Sprachstrings

Connectors werden als Teil der Power Automate-Lokalisierung lokalisiert. Daher ist bei der Entwicklung eines Connectors die Qualität der englischsprachigen Zeichenfolgen der Schlüssel zur Übersetzungsqualität. Hier sind einige wichtige Bereiche, auf die Sie sich beim Erstellen der Werte der von Ihnen bereitgestellten Zeichenfolgen konzentrieren sollten.

  • Um sicherzustellen, dass alle Zeichenfolgenwerte frei von Tippfehlern sind, stellen Sie sicher, dass Sie ein Rechtschreibprüfungsprogramm ausführen. Wenn eine unvollständige englische Zeichenfolge vorhanden ist, ist das Übersetzungsergebnis unvollständig oder im Kontext falsch.

  • Achte darauf, dass der Satz vollständig ist. Wenn der Satz nicht vollständig ist, kann dies auch zu Übersetzungen von geringerer Qualität führen.

  • Stellen Sie sicher, dass die Bedeutung des Satzes klar ist. Wenn die Bedeutung des Satzes mehrdeutig ist, kann dies auch zu schlechteren oder falschen Übersetzungen führen.

  • Achten Sie darauf, dass Zusammenfassungen, x-ms-summaries und Beschreibungen grammatikalisch korrekt sind. Kopieren Sie sie nicht und fügen Sie sie nicht ein. Um zu erfahren, wie sie im Produkt angezeigt werden, gehen Sie zu Anleitung zu Anschlusszeichenfolgen.

  • Vermeiden Sie nach Möglichkeit zusammengesetzte Laufzeitstrings. Verwenden Sie stattdessen vollständig gebildete Sätze. Verkettete Zeichenfolgen oder Sätze erschweren die Übersetzung oder können zu einer falschen Übersetzung führen.

  • Wenn Sie Abkürzungen verwenden, stellen Sie sicher, dass sie groß geschrieben werden, um sie deutlich zu machen. Dies verringert die Wahrscheinlichkeit, dass es mit einem typografischen Fehler verwechselt wird.

  • Zeichenfolgen in CaMel-Form (z. B. minimizeHighways oder MinimizeHighways) werden normalerweise als nicht übersetzbar angesehen. Wenn Sie den String-Wert lokalisieren möchten, sollten Sie den CaMel-Formularstring korrigieren.

Schritt 3: Die Lösungsprüfung ausführen, um Ihren Konnektor zu überprüfen

Die Lösungsprüfung ist ein Mechanismus zur Durchführung statischer Analysen, um sicherzustellen, dass Ihr Connector den von Microsoft für die Zertifizierung geforderten Standards entspricht. Fügen Sie Ihren Connector einer Lösung in Power Automate oder Power Apps hinzu, und führen Sie die Lösungsprüfung aus, indem Sie die Anweisungen unter Validieren Sie einen benutzerdefinierten Connector mit der Lösungsprüfung befolgen.

Sehen Sie sich dieses Video an, um zu erfahren, wie Sie den Solution Checker ausführen.

Schritt 4: Metadaten hinzufügen

Ihre Konnektor-Artefakte (Dateien) müssen spezifische Metadaten enthalten, die den Konnektor und seinen Enddienst beschreiben. Die in Metadaten zur Verfügung gestellten Informationen werden in unserer Konnektor-Dokumentation veröffentlicht und sind für alle Benutzer öffentlich zugänglich. Geben Sie keine privaten oder vertraulichen Informationen an und lassen Sie uns über Ihren Microsoft-Kontakt wissen, wenn es Probleme bei der Bereitstellung dieser Informationen gibt. Um zu erfahren, wie die Metadaten dokumentiert werden, besuchen Sie eine der konnektorspezifischen Dokumentationsseiten unter Konnektor-Referenz.

Schritt 4a: Herausgeber und stackOwner-Eigenschaften

  • “publisher“ ist der Name Ihrer Firma oder Organisation. Geben Sie den vollständigen Firmennamen an (z. B. "Contoso Corporation"). Diese Angabe muss im alphanumerischen Format erfolgen.
  • „stackOwner“ ist die besitzende Firma oder Organisation des Backend-Service-Stacks, mit dem sich der Konnektor verbindet. Diese Angabe muss im alphanumerischen Format erfolgen.
Verleger Beschreibung Beispiel
Überprüft Der Herausgeber und der stackOwner sind identisch, es sei denn, der ISV erstellt einen Konnektor im Auftrag eines stackOwner. „Publisher“: „Tesla“,
„stackOwner“: „Tesla“
Unabhängig Sie müssen den Besitzer des Stacks und den Besitzer des Publishers angeben. „publisher“: „Nirmal Kumar“,
„stackOwner“: „ITGlue“

Dateispeicherort: openapidefinition.json

Syntax: Die Eigenschaften publisher und stackOwner sind als Eigenschaften der obersten Ebene in der Datei openapidefinition.json vorhanden. Fügen Sie die folgenden hervorgehobenen Zeilen wie gezeigt hinzu. Achten Sie darauf, dass Sie den Eigenschaftsnamen und das Schema genau wie gezeigt eingeben.

Screenshot mit den Eigenschaften von Herausgeber und StackOwner, die in Beispielcode-Snippets verfügbar sind.

Schrtit 4c: Beispiel-Codeausschnitte

Sie können die folgenden Codeausschnitte verwenden, um Ihre Informationen zu kopieren und einzugeben. Stellen Sie sicher, dass Sie die Ausschnitte den richtigen Dateien an den richtigen Speicherorten hinzufügen, wie im vorherigen Abschnitt beschrieben.

    "publisher": "_____",
    "stackOwner": "_____"

    "contact": {
      "name": "_____",
      "url": "_____",
      "email": "_____"
    }

    "x-ms-connector-metadata": [
      {
        "propertyName": "Website",
        "propertyValue": "_____"
      },
      {
        "propertyName": "Privacy policy",
        "propertyValue": "_____"
      },
      {
        "propertyName": "Categories",
        "propertyValue": "_____;_____"
      }
    ]

Hinweis

Es gibt derzeit eine Einschränkung bei der Verwendung der Eigenschaft stackOwner und dem Paconn CLI Tool. Weitere Informationen finden Sie unter Einschränkungen in der README-Datei.

Schritt 4d: JSON-Dateiformatierung und Beschränkungen

  • Stellen Sie sicher, dass Ihre Eigenschaften richtig ausgerichtet sind.

  • Fügen Sie Ihr JSON in den Visual Studio-Code ein. Sie kölnnen Erweiterungen wie Rechtschreibprüfungen und Plugins wie JSON-Plugins verwenden.

  • Swagger-Dateien sollten nicht größer als 1 MB sein.

    • Überlegen Sie sich das Design Ihres Konnektors, bevor Sie ihn erstellen. Prüfen Sie, ob der Konnektor in zwei (2) oder mehr Konnektoren aufgeteilt werden sollte.
    • Größere Swagger-Dateien können zu einer Verzögerung bei der Verwendung des Konnektors führen.

    Zum Beispiel gibt es drei (3) verschiedene HubSpot-Connectors auf der Plattform.

    Screenshot der Ordner für die drei HubSpot Anschlüsse.

Schritt 5: Übermittlungsanforderungen für Plug-Ins erfüllen

Dieser Abschnitt gilt, wenn Sie auch das zugehörige Connector-Plug-In zur Zertifizierung einreichen.

Schritt 6: Connector- und/oder Plug-In-Artefakte vorbereiten

Hinweis

  • Stellen Sie sicher, dass Sie die Spezifikationen eingehalten und die Qualität Ihres Connectors und/oder Plugins vor der Zertifizierung sichergestellt haben. Andernfalls führen die erforderlichen Änderungen zu Verzögerungen bei der Zertifizierung.
  • Geben Sie eine Produktionsversion der Host-URL an. Staging-, Dev- und Test-Host-URLs sind nicht zugelassen.

Sie übermitteln Microsoft einen Satz von Dateien, bei dem es sich um eine Lösungsgenerierung vom Maker-Portal oder Microsoft Copilot Studio handelt. Um Ihre Dateien zu verpacken, folgen die Schritte in diesem Abschnitt.

Verpackungsleitfaden für Konnektoren und Plug-Ins

Die Verfahren in diesem Abschnitt führen Sie durch verschiedene Verpackungsszenarien. Wenn Sie nur einen benutzerdefinierten Connector verpacken möchten, verwenden Sie das erste Szenario. Wenn Sie sowohl einen benutzerdefinierten Connector als auch Plugins verpacken möchten, verwenden Sie das zweite Szenario. Wenn Sie einen vorhandenen Connector und Plug-Ins verpacken möchten, verwenden Sie das letzte Szenario.

Ihren benutzerdefinierten Connector packen und für die Zertifizierung einreichen

  1. Benutzerdefinierte Connectors für eine Lösung erstellen

  2. Führen Sie die Lösungsprüfung aus für Ihre Connector-Lösung in Schritt 1.

  3. Exportieren Sie die Connector-Lösung.

  4. Erstellen Sie einen Flow (Test) mit dem neu erstellten benutzerdefinierten Connector und fügen Sie den Flow einer Lösung hinzu.

  5. Exportieren Sie die Flow-Lösung.

  6. Erstellen Sie ein Paket mit den Lösungen aus den Schritten 3 und 5.

  7. Erstellen Sie eine intro.md-Datei.

  8. Erstellen Sie das endgültige Paket als ZIP-Datei im folgenden Format:

    Screenshot der Ordner und Dateien in einer ZIP-Datei für einen zu zertifizierenden zertifizierten Connector.

Hinweis

The names of the folder and files outside the solution are only for reference—you can choose as per your requirements. However, don't manipulate the files inside the solution.

  1. Laden Sie das Paket in einen Speicherblob hoch und generieren Sie eine SAS-URL. Stellen Sie sicher, dass Ihre SAS-URI mindestens 15 Tage gültig ist.
  2. Senden Sie Ihr Paket an das Partner Center.

Benutzerdefinierte Connectors und Plug-Ins für die Zertifizierung packen

  1. Befolgen Sie die Schritte 1 bis 5 unter Ihren benutzerdefinierten Connector packen und für die Zertifizierung einreichen in diesem Artikel.

  2. Erstellen Sie ein Plug-In im Microsoft Copilot Studio-Portal und exportieren Sie es als Lösung.

  3. Erstellen Sie ein Paket aus Folgendem:

  4. Erstellen Sie eine intro.md-Datei.

  5. Erstellen Sie das endgültige Paket als ZIP-Datei im folgenden Format.

    Screenshot der Ordner und Dateien in einer ZIP-Datei für zu zertifizierende zertifizierte Connectors und Plug-Ins.

Hinweis

The names of the folder and files outside the solution are only for reference—you can choose as per your requirements. However, don't manipulate the files inside the solution.

  1. Laden Sie das Paket in einen Speicherblob hoch und generieren Sie eine SAS-URL. Stellen Sie sicher, dass Ihre SAS-URI mindestens 15 Tage gültig ist.
  2. Senden Sie Ihr Paket an das Partner Center.

Vorhandene zertifizierte Connectors und Plug-Ins für die Zertifizierung packen

  1. Erstellen Sie eine Lösung in Power Automate und fügen Sie den bereits zertifizierten Connector hinzu.

  2. Befolgen Sie die Schritte 2 bis 4 unter Ihren benutzerdefinierten Connector packen und für die Zertifizierung einreichen in diesem Artikel.

  3. Erstellen Sie ein Plug-In in Copilot Studio und exportieren Sie es als Lösung.

  4. Exportieren Sie das Plug-in als Lösung.

  5. Erstellen Sie ein Paket aus Folgendem:

  6. Erstellen Sie eine intro.md-Datei.

  7. Erstellen Sie das endgültige Paket als ZIP-Datei im folgenden Format.

    Screenshot der Ordner und Dateien in einer ZIP-Datei für einen vorhandenen zertifizierten Connector und ein zu zertifizierendes Plugin.

Hinweis

The names of the folder and files outside the solution are only for reference—you can choose as per your requirements. However, don't manipulate the files inside the solution.

  1. Laden Sie das Paket in einen Speicherblob hoch und generieren Sie eine SAS-URL. Stellen Sie sicher, dass Ihre SAS-URI mindestens 15 Tage gültig ist.
  2. Senden Sie Ihr Paket an das Partner Center.

Sowohl verifizierte als auch unabhängige Herausgeber laden ihre Artefakte herunter. openapidefinition.json Sie müssen die IconBrandColor in dieser Datei festlegen.

  • Verifizierte Herausgeber: Legen Sie iconBrandColor in der OpenAPIDefinition-Datei auf Ihre Markenfarbe fest.
  • Unabhängige Herausgeber: Setzen Sie iconBrandColor in der OpenAPIdefinitionsdatei auf „#da3b01“.
    Screenshot eines leuchtend orangefarbenen Symbols (da3b01).

Ein intro.md-Artefakt erstellen

Eine intro.md-Datei ist sowohl für unabhängige Herausgeber als auch für verifizierte Herausgeber erforderlich. Sie müssen eine intro.md-Datei erstellen, um die Features und Funktionen Ihres Connectors zu dokumentieren. Ein Beispiel für die einzuschließende Dokumentation finden Sie unter Readme.md-Beispiel. Um zu erfahren, wie Sie eine intro.md-Datei schreiben, sehen Sie sich andere intro.md-Dateien (auch bekannt als Readme.md-Dateien) in unserem GitHub-Repository an.

Wenn Sie ein unabhängiger Publisher sind und Ihr Konnektor OAuth verwendet, stellen Sie sicher, dass Sie Anweisungen für die Beschaffung von Anmeldeinformationen einfügen.

Tipp

Bekannte Probleme und Einschränkungen ist ein guter Abschnitt, den Sie pflegen sollten, um Ihre Benutzer auf dem Laufenden zu halten.

Schritt 7: Überprüfen Sie das Paket auf Struktur

Das Paketvalidierungsskript validiert die Paketstruktur und hilft Ihnen, das Paket in einem für die Zertifizierung akzeptablen Format zu generieren. Laden Sie das Paketvalidierungsskript mit diesem Link herunter: ConnectorPackageValidator.ps1.

Um das Skript auszuführen, folgen diese Schritte:

  1. Öffnen Sie Windows PowerShell im Administratormodus.

    Screenshot von Windows PowerShell im Administratormodus.

  2. Ändern Sie den Laufwerkspeicherort durch Eingabe von cd /.

    Das folgende Beispiel verwendet C:\.

    Screenshot der Syntax zum Ändern des Laufwerks.

  3. Gehen Sie zu dem Pfad, in den Sie das Paketvalidierungsskript heruntergeladen haben.

    Wenn der Pfad beispielsweise C:\Users\user01\Downloads lautet, geben Sie cd .\Users\user01\Downloads\ ein.

    Screenshot der Syntax zum Ändern des Pfads.

  4. Legen Sie die Ausführungsrichtlinie auf „uneingeschränkt“ fest, indem Sie den folgenden Befehl eingeben:

    Set-ExecutionPolicy -ExecutionPolicy Unrestricted

    Screenshot der Syntax zum Festlegen der Ausführungsrichtlinie.

    Dieser Befehl ermöglicht die uneingeschränkte Ausführung der PowerShell.

  5. Bestätigen Sie Ihre Eingabe mit der Eingabe von Y, was Ja bedeutet.

  6. Führen Sie ConnectorPackageValidator.ps1 mit den folgenden Schritten aus:

    1. Geben Sie den ZIP-Dateipfad ein, der das Connector-Paket enthält.
    2. Geben Sie an, ob KI-Plug-In aktiviert ist oder nicht.

    Wie im folgenden Beispiel gezeigt, ist das erste Argument ein gültiger ZIP-Dateipfad, der das Paket enthält. Das zweite Argument yes/y zeigt an, dass KI-Plug-In aktiviert ist, oder no/n zeigt an, dass es deaktiviert ist.

    Screenshot der Syntax zum Ausführen von ConnectorPackageValidator.ps1.

    Wenn die Paketstruktur korrekt ist, wird folgende Erfolgsmeldung angezeigt:

    Screenshot der Erfolgsmeldung.

    Wenn ein Problem mit der Paketstruktur vorliegt, stellt das Skript Problemdetails bereit, indem es die Defekte in der Paketstruktur erkennt und hervorhebt.

    Screenshot der Problemdetails.

Schritt 8: Connector und/oder Plug-In für die Zertifizierung einreichen

Während des Einreichungsprozesses stellen Sie Ihren Konnektor und/oder Ihr Plug-In für unser Microsoft Power Platform-Konnektorenrepository als Open Source bereit.

  1. (Für unabhängige Herausgeber) Um das Paket zur Zertifizierung an Microsoft zu senden, befolgen Sie die Anweisungen im Zertifizierungsprozess für unabhängige Herausgeber.

  2. (Für verifizierte Herausgeber) Um das Paket zur Zertifizierung an Microsoft an das Partner Center zu senden, befolgen Sie die Anweisungen im Zertifizierungsprozess für verifizierte Herausgeber.

    Wenn Sie ein verifizierter Herausgeber sind, müssen Sie eine script.csx-Datei senden, wenn Sie angepassten Code verwenden.

    Wenn Ihr Connector über OAuth verfügt, geben Sie Client-ID und Geheimschlüssel im Partner Center an. Holen Sie sich außerdem den API-Namen aus Ihrer Connector-Übermittlungsanforderung, um Ihre App zu aktualisieren.

    Im Rahmen der Einreichung zertifiziert und/oder fügt Microsoft Ihren Connector hinzu. Wenn Sie Swagger-Fehler beheben müssen, gehen Sie zu Swagger Validator-Fehler beheben.

Checkliste vor dem Senden

Bevor Sie mit Senden Sie Ihren Konnektor für die Microsoft-Zertifizierung fortfahren, stellen Sie sicher, dass:

Tipp

  • Erstellen Sie YouTube-Videos, Blogs oder andere Inhalte, um Beispiele oder Screenshots für die ersten Schritte mit dem Konnektor und/oder Plug-In bereitzustellen.
  • Fügen Sie die Links in die intro.md-Datei ein, damit wir sie zu unseren Dokumenten hinzufügen können.
  • Fügen Sie Tooltips zu Ihrer Swagger-Datei hinzu, um Ihren Benutzern zu helfen, erfolgreicher zu sein.

Nächster Schritt