Freigeben über

Tutorial: Registrieren eines Azure-fähigen Plug-ins mit dem Plug-in Registration Tool

  • Artikel

Diese exemplarische Vorgehensweise zeigt, wie Sie einen Dienst-Endpunkt-Schritt mit dem Plug-in Registration Tool registrieren. Einmal konfiguriert, kann Microsoft Dataverse den Ausführungskontext des aktuellen Vorgangs an einen Azure-Lösungsendpunkt posten. Für diese exemplarische Vorgehensweise wird der Schritt registriert, um den Ausführungskontext der Nachricht CreateRequest für eine Tabelle Account an den Azure Service Bus zu posten.

Die folgenden Voraussetzungen müssen erfüllt sein, bevor Sie diese exemplarische Vorgehensweise starten:

  • Zugriff auf das Plug-in Registration Tool. Das Plugin Registration Tool finden Sie unter Tools von NuGet herunterladen.
  • Ihre Dataverse-Systembenutzerfirma muss über die Rolle „Systemanpasser“ oder „Systemadministrator“ verfügen.
  • Erhalten Sie Zugang zu einem Azure-Plattform-Dienstnamespace, das für SAS-Autorisierung konfiguriert ist, zu der Dataverse eine Nachricht veröffentlicht.
  • Wenn Sie planen, irgendeine andere Azure-Nachrichtenentität als eine Warteschlange zu benutzen, zum Beispiel eine Weiterleitung, muss es eine Listener-Anwendung geben, die aktiv auf den spezifizierten Lösungsendpunkt für Dataverse lauscht, um erfolgreich an den Azure Service Bus bereitzustellen. Weitere Informationen finden Sie unter Schreiben eines Listeners für eine Azure-Lösung.
  • Ein konfigurierter Service-Endpunkt mit SAS-Autorisierung ist in der Zielorganisation verfügbar. Weitere Informationen: Exemplarische Vorgehensweise: Microsoft Azure (SAS) für die Integration in Dataverse konfigurieren.

Schritte

Diese exemplarische Vorgehensweise enthält die folgenden Schritte:

  1. Mit Dataverse verbinden
  2. Registrieren Sie einen Dienstendpunktschritt für ein Ereignis
  3. Testen Sie die Endpunktregistrierung

Mit Dataverse verbinden

Führen Sie die unten angegebenen Schritte aus, um mithilfe des Plugin Registration Tool eine Verbindung mit Dataverse herzustellen.

  1. Führen Sie das Plug-In-Registrierungstool aus.

  2. Klicken Sie auf Create New Connection (Neue Verbindung erstellen).

  3. Wählen Sie im Dialogfeld Anmelden die Option Microsoft 365 aus.

    Anmeldeformular für eine Online-Bereitstellung.

  4. Wenn Sie Liste der verfügbaren Organisationen anzeigen aktivieren, wird eine Liste von Organisationen angezeigt, denen Sie angehören, nachdem Sie auf Anmeldung klicken. Dadurch können Sie die Organisation auswählen, mit der Sie den Dienstendpunkt registrieren möchten. Andernfalls wird die standardmäßige Organisation verwendet.

  5. Geben Sie die angegebenen Informationen über den Server und das Anmeldekonto ein und klicken Sie dann auf Anmelden.

Registrieren Sie einen Dienstendpunktschritt für ein Ereignis

Führen Sie die unten angegebenen Schritte aus, um auf dem Dienstendpunkt einen Schritt für ein Ereignis zu registrieren.

  1. Wählen Sie in der Registerkarte der Organisationsregisterkarte einen Dienstendpunkt aus.

  2. Navigieren Sie zum Menü Registrieren, oder klicken Sie auf Neuen Schritt registrieren.

  3. Füllen Sie das Dialogfeld Neuen Schritt registrieren für ein Ereignis zum Erstellen einer Firma aus, wie in der folgenden Abbildung gezeigt.

    Erstellt eines Dienstendpunktschrittes.

  4. Klicken Sie auf Neuen Schritt registrieren.

Dataverse wird nun die aktuelle Nachricht, die den Ausführungskontext enthält, an den Service Bus senden, sobald ein Konto erstellt wird. Der Post wird asynchron ausgeführt und wird nicht sofort ausgeführt.

Hinweis

Registrierte Dienstandpunkte unterstützen nur Port 80 für HTTP und Port 443 für HTTPS.

Testen der Endpunktregistrierung

Nachdem der Endpunkt registrieren ist, können Sie diesen testen. Ein Listener muss ausgeführt werden oder eine Warteschlange muss auf dem Ziel-Endpunkt verfügbar sein, damit der Service-Bus-Post vom Plugin erfolgen kann.

  1. Öffnen Sie eine Canvas- oder modellgesteuerte Anwendung für dieselbe Organisation, unter der Sie den Dienstendpunkt registriert haben.
  2. Erstellen Sie einen neuen Datensatz in der Tabelle „Konto“.
  3. Geben Sie einen Firmennamen, beispielsweise „Adventure Works Cycle” in das Feld Firmenname ein und klicken Sie dann auf Speichern.
  4. Warten Sie etwa 10 Minuten, damit der Azure Service Bus-Beitrag erfolgen kann.
  5. Wählen Sie in der modellgesteuerten App Dynamics 365 – benutzerdefiniert die Optionen Einstellungen > System > Systemaufträge aus.
  6. Öffnen Sie den Systemauftrag, der denselben Namen hat, den Sie auch für Ihren Dienstendpunkt angegeben haben. Überprüfen Sie den Status, um zu sehen, ob der Post erfolgreich war, wartet oder fehlerhaft war.

Sie können die Registrierung des Endpunkts jetzt aufheben, wenn Sie das wünschen, indem Sie ihn in der Strukturansicht des Tools auswählen und auf Registrierung aufheben klicken.

Siehe auch

Azure-Integration für Dataverse
Einführung in die Microsoft Azure-Integration mit Dataverse

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).