Freigeben über


Testen und Verteilen eines benutzerdefinierten Konnektors

             Kostenlose Testversion

Wichtig

Einige oder alle dieser Funktionen sind als Teil einer Vorschauversion verfügbar. Inhalt und Funktionalität können sich ändern.

Dieser Artikel enthält Informationen zum Testen und Verteilen Ihres benutzerdefinierten Datenimport-Konnektors in Microsoft Sustainability Manager.

Konnektor-UI testen

Indem Sie diese Schritte befolgen, können Sie sehen, wie die Benutzeroberfläche für Ihren Konnektor aussieht.

  1. Exportieren Sie die Power Platform Lösung, die Sie zuvor erstellt haben, indem Sie die Schritte unter Lösungen exportieren befolgen. Stellen Sie sicher, dass die von Ihnen exportierte Lösungsversionsnummer höher ist als die aktuelle Version. Sie importieren die Lösung erneut, nachdem Sie die zuvor erstellte XML-Datei hinzugefügt haben.

  2. Extrahieren Sie die exportierten ZIP-Dateien und erstellen Sie einen neuen Ordner mit dem Namen Assets.

  3. Speichern Sie die Datei msdyn_dataconnectors.xml (und die Datei msdyn_dataflowtemplates.xml für einen Power Query Vorlagenconnector) im Ordner Assets.

    Für einen Power Automate Konnektor sollte Ihre Ordnerstruktur jetzt folgendermaßen aussehen:

    Screenshot, der den Ordner und die Dateien in der ZIP-Datei für einen Power Automate Konnektor zeigt.

    Für einen Power Query-Vorlagen-Konnektor sollte Ihre Ordnerstruktur folgendermaßen aussehen:

    Screenshot, der den Ordner und die Dateien in der ZIP-Datei für einen Power Query-Vorlagen-Konnektor zeigt.

  4. Wählen Sie alle Dateien aus und komprimieren Sie sie in eine ZIP-Datei. Wenn Sie Ihre neu erstellte ZIP-Datei öffnen, sollte die Ordnerstruktur der obersten Ebene diese Elemente enthalten:

    • Ordner „Assets“
    • [Inhaltstypen] Datei
    • customizations.xml Datei
    • solution.xml Datei
    • ZIP-Datei mit Vorlagenlösungen (für Power Query Vorlagenkonnektoren)
  5. Importieren Sie die ZIP-Datei erneut in dieselbe Power Platform Umgebung, aus der Sie sie exportiert haben. Führen Sie dazu die Schritte unter Lösungen importieren aus.

  6. Nachdem der Import erfolgreich abgeschlossen ist, wird in dieser Umgebung ein Konnektor angezeigt. Im Sustainability Manager im Daten wählen Sie im linken Navigationsbereich Importe. Wählen Sie Neu und dann DATENANBIETER-KONNEKTOREN. Ihre Konnektor-Kachel wird auf der nächsten Seite angezeigt. Wählen Sie Ihre Konnektorkachel und dann Weiter aus.

    Für einen Power Automate Konnektor wird die Benutzeroberfläche für das von Ihnen entworfene Anmeldeinformationsformular angezeigt. Auf dieser Seite können Sie sich vergewissern, dass alles richtig aussieht und Fehler im Formular beheben.

    Für einen Power Query Vorlagen-Konnektor, wird die Power Query-Vorlagenimporterfahrung angezeigt.

    Wenn Sie Änderungen vornehmen möchten, folgen Sie den Schritten zum Exportieren der Lösung, aktualisieren Sie die msdyn_dataconnectors.xml Datei und importieren Sie sie anschließend erneut. Stellen Sie sicher, dass die Version, die Sie exportieren, höher ist als die aktuelle Version.

  7. Sie können das Formular mit Beispielwerten ausfüllen und speichern. Um zu überprüfen, wie diese Werte in Power Apps gespeichert werden, wählen sie Tabellen. Wählen Sie Alle aus, und suchen Sie nach msdyn_providercredential. Die Daten in der Tabelle werden angezeigt. Wenn Sie die Verbindung zum ersten Mal herstellen, sollte nur ein Anmeldedatensatz vorhanden sein. Überprüfen Sie die Anmeldeinformationen Spalte, um zu sehen, wie die von Ihnen im Formular angegebenen Werte gespeichert werden.

    Screenshot, der die Spalte „Anmeldeinformation“ in der Tabelle „msdyn_providercredential“ zeigt.

Test für die Fehlerbehandlung

Für Power Automate Konnektoren ist es wichtig, Fehler in Ihrem Verbindungsfluss zu behandeln. Wenn aus irgendeinem Grund ein Schritt im Ablauf fehlschlägt, bleibt der Datenimportstatus hängen als Geplant.

Um dieses Ereignis zu testen, fügen Sie Ihre Aktionen im Flow in einem Try/Catch-Block hinzu. Lassen Sie im Catch-Block die Verbindung fehlschlagen und die Verbindung aktualisieren.

Wenn die Verbindung fehlschlägt, sollten Ihre Benutzer über den Support-Link, den Sie in das JSON für die Benutzeroberfläche Ihres Konnektors aufgenommen haben, Kontakt mit Ihnen aufnehmen können. Dieses JSON erscheint in Schritt 2: Erstellen eines Konnektor-Datensatzes.

Um die Verbindung fehlschlagen zu lassen und die Verbindung zu aktualisieren, verwenden Sie die Aktualisieren einer Zeile Dataverse Aktion für Verbindungsaktualisierung und Verbindung Datensätze.

  • Für den Datensatz Verbindungsaktualisierung stellen Sie das Feld Aktualisierungsstatus auf Fehlgeschlagen:

    Screenshot, der zeigt, wie Sie das Feld „Aktualisierungsstatus des Verbindungsaktualisierungsdatensatzes“ auf „Fehlgeschlagen“ setzen in einem Power Automate-Flow.

  • Für den Datensatz Verbindungsaktualisierung stellen Sie das Feld Status auf Fehler:

    Screenshot, der zeigt, wie Sie das Feld „Status des Verbindungsaktualisierungsdatensatzes“ auf „Fehlgeschlagen“ setzen in einem Power Automate-Flow.

Weitere Informationen finden Sie unter Verwenden eines Flows zum Aktualisieren einer Zeile.

Weitere Informationen zur Fehlerbehandlung finden Sie unter Best Practices für die Fehlerbehandlung in Power Automate Flows.

Testen Sie Ihren Konnektor

Nachdem Sie Ihren Konnektor erstellt haben, können Sie ihn als verwaltete Lösung exportieren, indem Sie die Schritte unter Lösungen exportieren befolgen.

Importieren Sie Ihre exportierte Lösung in andere Umgebungen, in denen Sustainability Manager installiert ist, und testen Sie Ihre Lösung, um sicherzustellen, dass sie wie vorgesehen funktioniert.

Verteilen Ihres Konnektors

Nachdem Sie Ihre Tests abgeschlossen haben, können Sie Ihre Lösung entweder privat direkt an Ihre Benutzer oder öffentlich über Microsoft AppSource verteilen. Weitere Informationen zum Verteilen über AppSource finden Sie unter Veröffentlichen einer App auf AppSource.

Siehe auch