Freigeben über


Debuggen eines lokal registrierten Plug-Ins

Allgemeine Informationen zum Plugin-Debugging finden Sie im Dataverse Thema Debuggen eines Plugins. Im Folgenden wird beschrieben, wie ein Plug-In bei Dynamics 365 Customer Engagement (on-premises) debuggt wird.

Notiz

Eine alternative Methode zum Debuggen eines Plug-Ins, das in der Sandbox bei jedem Bereitstellungstyp ausgeführt wird, ist die Verwendung des Tracing-Service. Weitere Informationen zum Ablaufverfolgung finden Sie unter Protokollierung und Ablaufverfolgung. Weitere Informationen zum Debuggen, einschließlich eines Tutorials, finden Sie im Dataverse Thema Debuggen eines Plugins.

 

Debuggen Sie ein Plug-In

  1. Registrieren Sie die Plug-In-Assembly und stellen Sie sie bereit.

    Liegt eine weitere Kopie der Assembly am gleichen Ort vor und kann die Kopie nicht überschrieben werden, da sie von Dynamics 365 Customer Engagement (on-premises) ausgeführt wird, müssen Sie den Serviceprozess, in dem das Plug-In ausgeführt wurde, neu starten. Informationen zum richtigen Serviceprozess finden Sie in der unten aufgeführten Tabelle. Weitere Informationen: Plug-ins registrieren und bereitstellen

  2. Konfigurieren Sie den Debugger.

    Fügen Sie den Debugger zum Prozess auf dem Dynamics 365 Server an, auf dem das Plug-In ausgeführt wird. Informationen zum Identifizieren des Prozesses finden Sie in der nachfolgenden Tabelle.

    Konfigurieren der Plug-In-Registrierung Dienstprozess
    Online w3wp.exe
    offline Microsoft.Crm.Application.Hoster.exe
    asynchrone registrierte Plug-Ins (oder benutzerdefinierte Workflow-Assemblys) CrmAsyncService.exe
    Sandkasten (Isolationsmodus) Microsoft.Crm.Sandbox.WorkerProcess.exe

    Wird die ausführbare Datei von mehreren Prozessen ausgeführt, z. B. mehreren w3wp.exe-Prozessen, fügen Sie den Debugger an alle Instanzen des ausgeführten ausführbaren Prozesses an. Legen Sie anschließend mindestens einen Haltepunkt in Ihrem Plug-In-Code fest.

  3. Testen Sie das Plug-In.

    Führen Sie die Dynamics 365 Customer Engagement (on-premises)-Anwendung oder eine andere benutzerdefinierte Anwendung, die das SDK verwendet, aus, und führen Sie die Aktion aus, die zum Ausführen des Plug-Ins erforderlich ist. Wenn z. B. ein Plug-In für ein Firmenerstellungsereignis registriert ist, erstellen Sie eine neue Firma.

  4. Debuggen Sie den Plug-In-Code.

    Nehmen Sie alle erforderlichen Änderungen an dem Code vor, damit er wie gewünscht ausgeführt wird. Wenn der Code geändert wird, kompilieren Sie den Code in eine Assembly und wiederholen Sie die Schritte 1 bis 4 dieser Vorgehensweise (falls erforderlich). Wenn Sie die Haupt- oder Nebenversionsnummern der Plug-In-Assembly ändern, müssen Sie die Registrierung der Vorversion der Assembly aufheben und die neue Version registrieren. Weitere Informationen: Plug-ins registrieren und bereitstellen

  5. Registrieren Sie das Plug-In in der Datenbank.

    Nachdem der Bearbeitungs-/Kompilierungs-/Bereitstellungs-/Test-/Debugzyklus abgeschlossen wurde, heben Sie die Registrierung für die Plug-In-Assembly auf (Datenträger oder GAC) auf und registrieren Sie das Plug-In dann erneut in der Dynamics 365 Customer Engagement (on-premises)-Apps-Datenbank. Weitere Informationen: Plug-ins registrieren und bereitstellen

Tipp

Es ist möglich, ein in der Datenbank bereitgestelltes Plug-In zu debuggen. Die Symboldatei (.pdb) der kompilierten Plugin-Montage muss in den Ordner <crm-root>\Server\bin\assembly kopiert werden und die Internet Information Services (IIS) müssen dann neu gestartet werden. Nachdem das Debuggen abgeschlossen wurde, müssen Sie die Symboldatei entfernen und IIS zurücksetzen, damit der Vorgang, der das Plug-In ausgeführt hat, keinen zusätzlichen Arbeitsspeichers verbraucht.

Weitere Informationen zum Debuggen eines Plugins mit dem Plug-in-Profiler-Tool finden Sie unter Debuggen eines Plugins.

Debuggen Sie ein Sandkasten-Plug-In

Es ist wichtig, diese Schritte vor der ersten Ausführung eines Sandkasten-Plug-Ins auszuführen. Wenn das Plug-In bereits ausgeführt wurde, ändern Sie entweder den Code der Assembly, sodass sich der Hash der Assembly auf dem Server ändert, oder starten Sie den Dynamics 365 Customer Engagement (on-premises) Sandbox Processing Service auf dem Sandkastenserver neu.

Konfigurieren Sie den lokalen Server

Der Sandkastenhostprozess überwacht den Sandkastenarbeitsprozess, in dem das Plug-In ausgeführt wird. Die Hostprozess überprüft, ob das Plug-In nicht mehr reagiert, Arbeitsspeicherschwellenwerte überschreitet, usw. Wenn der Arbeitsprozess 30 Sekunden nicht reagiert, wird er heruntergefahren. Um ein Sandkasten-Plug-in zu debuggen, müssen Sie diese Herunterfahrfunktion deaktivieren. Um die Herunterfahrfunktion zu deaktivieren, müssen Sie den folgenden Registrierungsschlüssel auf 1 festlegen (DWORD):

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM\SandboxDebugPlugins  

Plug-In debuggen

Führen Sie die folgenden Schritte aus, um ein Sandkasten-Plug-in zu debuggen.

  1. Registrieren Sie das Plug-In im Sandkasten (Isolationsmodus) und stellen Sie es für die Dynamics 365 Serverdatenbank bereit.

  2. Kopieren Sie die Symboldatei (.pdb) der kompilierten Plug-In-Assembly in den server\bin\assembly-Ordner auf dem Server, auf dem der Sandkastenarbeitsprozess Microsoft.Crm.Sandbox.WorkerProcess.exe ausgeführt wird. Dies ist der Server, auf dem die Sandbox Processing Service-Rolle gehostet wird.

  3. Befolgen Sie die Anweisungen in den Schritten 2 bis 4, die am Anfang dieses Themas gezeigt wurden.

    Weitere Informationen zum Debuggen eines Plugins mit dem Plug-in-Profiler-Tool finden Sie unter Debuggen eines Plugins.

Siehe auch

Plug-In-Entwicklung
Debuggen Sie ein Plug-In
Registrieren und Bereitstellen von Plug-Ins
Schreiben eines Plug-Ins