Exemplarische Vorgehensweise: Registrieren eines Plug-Ins mithilfe des Plug-In-Registrierungstools

Artikel
03/04/2017

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Diese exemplarische Vorgehensweise veranschaulicht, wie ein Plug-In mithilfe des im SDK bereitgestellten Plug-in Registration-Tools registriert wird. Das Plug-In zum Registrieren ist das FollowupPlugin aus dem Beispiel: Erstellen eines grundlegenden Plug-Ins-Thema.

Das Plug-In soll in der account-Entität, in der CreateRequest-Nachricht, in einem Post-Event und in dem Sandkasten registriert werden. Das Plug-In kann auf jeder beliebigen Microsoft Dynamics 365 (online und lokal)-Bereitstellung registriert werden, für die Ihr Benutzerkonto die Rolle des Systemanpassers oder des Systemadministrators besitzt.

Die folgenden Voraussetzungen müssen zum Ausführen dieser exemplarischen Vorgehensweise erfüllt sein:

Rufen Sie das PluginRegistration.exe-Tool auf, das sich im Tools\PluginRegistration-Ordner des SDK befindet.Laden Sie das Microsoft Dynamics CRM SDK-Paket herunter.
Erwerben Sie ein Systembenutzerkonto auf einem Microsoft Dynamics 365-Server.
Ihr Benutzerkonto muss die Rolle des Systemanpassers oder Systemadministrators besitzen. Siehe So kann die rollenbasierte Sicherheit verwendet werden, um den Zugriff auf Entitäten in Microsoft Dynamics 365 zu steuern.

Herstellen einer Verbindung mit dem Microsoft Dynamics 365-Server

Führen Sie das Plug-in Registration Tool aus.
Klicken Sie auf Neue Verbindung erstellen.
Wählen Sie im Dialogfeld Anmeldung das Optionsfeld für den Bereitstellungstyp gemäß dem Microsoft Dynamics 365-Server aus, für den Sie Plug-Ins registrieren möchten. Das Optionsfeld Lokal enthält eine IFD-Bereitstellung, das Optionsfeld Online ist für den Windows Live-Anbieter von Microsoft Dynamics 365 (online) und das Optionsfeld Office 365 ist für den Microsoft Online Services-Anbieter von Microsoft Dynamics 365 (online).

Anmeldefenster für eine Onlinebereitstellung

Anmeldefenster für eine lokale Bereitstellung
Wenn Sie Liste der verfügbaren Organisationen immer 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, für die Sie das Plug-In registrieren möchten. Andernfalls wird die standardmäßige Organisation verwendet.
Geben Sie die angegebenen Informationen zum Server und der Firma ein und klicken Sie dann auf Anmeldung.

Es sollte eine reduzierte Liste mit registrierten Plug-In- oder benutzerdefinierten Workflowaktivitätsassemblys und Dienstendpunkten angezeigt werden. Die Aktivitätsfeeds und Microsoft.Crm.ObjectModel-Assemblys sind für die ordnungsgemäße Funktion von Microsoft Dynamics 365 erforderlich, damit das Tool das Ändern dieser Elemente verhindert. Wenn Sie ein Element in der Liste auswählen, werden auf den Registerkartenbereichen Eigenschaften und Details Informationen über dieses Listenelement anzeigen.

Das Hauptfenster der Anwendung

Plug-In-Assembly registrieren

Wählen Sie eine Organisationsregisterkarte aus, um sie zu aktivieren.
Klicken Sie in der Symbolleiste der Registerkarte auf Registrieren und dann auf Neue Assembly registrieren.
Klicken Sie im Dialogfeld Neue Assembly registrieren rechts neben dem Feld Schritt 1 auf die Schaltfläche mit den Auslassungspunkten […].
Navigieren Sie im Dialogfeld Öffnen zum Speicherort der kompilierten SamplePlugin.dll-Assembly. Der Standardspeicherort ist SDK\SampleCode\CS\Plug-ins\bin\Debug. Wählen Sie die Assembly aus, und klicken Sie auf Öffnen.
Erweitern Sie im Abschnitt Schritt 2 die Assembly SamplePlugins, um alle Plug-Ins in dieser Assembly anzuzeigen. Aktivieren Sie nur das Plug-In Microsoft.Crm.Sdk.Samples.FollowupPlugin.
Wählen Sie im Abschnitt Schritt 3 die Option Sandkasten aus.
Wählen Sie im Abschnitt Schritt 4 die Option Datenbank aus.

Dialog zum Registrieren einer Assembly
Wählen Sie Ausgewählte Plug-ins registrieren aus. Sie können alle offenen Dialogfelder schließen.

Ein registriertes Plug-In wird in der Strukturansicht angezeigt.

Tipp

Sehen Sie einen Fehler im Bereich Protokoll und das Protokoll enthält die folgende Meldung?

<Message>Action failed for assembly 'SamplePlugins, Version=0.0.0.0, Culture=neutral, PublicKeyToken=829f574d80e89132': Deployment/Scalegroup does not allow running external code.</Message>

Sollte dies der Fall sein, müssen Sie benutzerdefinierten Code auf dem Server aktivieren und es erneut versuchen. Weitere Informationen finden Sie unter Aktivieren oder Deaktivieren der Ausführung von benutzerdefiniertem Code.

Die SamplePlugins.dll-Assembly und das FollowupPlugin-Plug-In sind jetzt registriert und werden auf dem Server bereitgestellt. Wenn Sie das Tool zum Registrieren einer benutzerdefinierten Workflowaktivitätsassembly verwendet haben, dann kommt der nächste Abschnitt zum Registrieren eines Schrittes nicht zur Anwendung.

Plug-In-Schritt für ein Ereignis registrieren

Erweitern Sie in der Strukturansicht Registrierte Plug-Ins und benutzerdefinierte Workflowaktivitäten den Knoten (Assembly) SamplePlugins, und wählen Sie ein registriertes Plug-In aus.
Navigieren Sie auf der Symbolleiste zum Menü Registrieren und klicken Sie dann auf Neuen Schritt registrieren.

Hinweis

Die Plug-Ins werden zur Ausführung registriert, wenn ein Ereignis in der Ereignisausführungspipeline verarbeitet wird. Jedes Ereignis verfügt über einen Phasennamen und eine Zahl, um entweder vor oder nach dem Kernplattformvorgang seine Position in der Pipeline anzugeben. Ein Schritt bezieht sich auf die Entität des SDK-Nachrichtenverarbeitungsschrittes, mit der konfiguriert wird, wann und wie das Plug-In ausgeführt werden soll.
Füllen Sie das Dialogfeld Neuen Schritt registrieren wie in der folgenden Abbildung aus.

Dialog zum Registrieren eines neuen Schrittes
Klicken Sie auf Neuen Schritt registrieren.
Erweitern Sie den Knoten (Assembly) SamplePlugins und die dazugehörigen Unterknoten, um die Plug-In- und Schrittknoten anzuzeigen, die Sie erstellt haben. Sie können das Tool jetzt zwar schließen, aber Sie sollten es möglicherweise geöffnet lassen, bis Sie das Plug-In getestet und die Registrierung der Assembly aufgehoben haben.

Hinweis

Um die Registrierung des Schrittes, des Plug-Ins oder der Assembly aufzuheben, wählen Sie den entsprechenden Knoten in der Struktur aus und klicken Sie dann auf der Symbolleiste auf Registrierung aufheben. Um eine Assembly oder Schrittregistrierung zu ändern, doppelklicken Sie in der Strukturansicht auf die Assembly oder den Schrittknoten. Sie können auch den Knoten auswählen und auf der Symbolleiste auf Aktualisieren klicken oder tippen.

Das Plug-In ist jetzt registriert, um im Sandkasten, für ein Firmenerstellungsereignis und nach der Ausführung des Kernvorgangs ausgeführt zu werden. Sie haben das Plug-In so registriert, dass es seit der Erstellung der Nachverfolgungsaktivität asynchron ausgeführt wird. Dieser Vorgang ist nicht zeitkritisch. Nachdem eine Firma erstellt wurde, wird das Plug-In ausgeführt, wenn der asynchrone Service das nächste Mal die Warteschlange verarbeitet.

Plug-In testen

Nach dem Registrieren des Plug-Ins können Sie optional seine Ausführung mithilfe des folgenden Verfahrens testen.

Öffnen Sie die Microsoft Dynamics 365-Webanwendung für dieselbe Organisation, für die Sie die Plug-In-Assembly registriert haben.
Wechseln Sie in den Arbeitsbereich, wählen Sie Firmen aus, und klicken Sie dann auf Neu.
Geben Sie im Feld Firmenname einen Namen ein (beispielsweise Adventure Works Cycle, und klicken Sie dann auf Speichern und schließen.
Doppelklicken Sie auf den Formularnamen im Raster Firmen, um das Formular zu öffnen.
Klicken Sie auf Aktivitäten, um eine Liste von zugehörigen Aktivitäten für die Firma anzuzeigen. Sie sollten die vom Plug-In erstellte Aktivität “Send email to the new customer“ sehen.
Wenn Sie das Plug-In für die asynchrone Ausführung registriert und im Formular Neuen Schritt registrieren nicht die Option AsyncOperation löschen, wenn StatusCode = Erfolgreich ausgewählt haben, ist ein neuer Systemauftrag namens “FollowupPlugin: Create of account” vorhanden. Klicken Sie zum Anzeigen des verknüpften Systemauftrags auf Einstellungen und anschließend auf Systemaufträge. Doppelklicken Sie auf den zuvor genannten Systemauftrag.

Wenn Sie möchten, können Sie jetzt die Registrierung des Plug-Ins, des Schritts und der Assembly aufheben. Sie sollten außerdem den erstellten Systemauftrag und die angelegte Firma löschen.

Siehe auch

Plug-In-Entwicklung
Exemplarische Vorgehensweise: Assemblysicherheit für ein Offline-Plug-In konfigurieren
Registrieren und Bereitstellen von Plug-Ins
Ereignisausführungspipeline
Plug-In-Isolation, Vertrauensstellungen und Statistiken
Unterstützte Meldungen für Entitäten und Plug-Ins

Microsoft Dynamics 365