Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Allgemeine Informationen zum Debuggen von Plug-Ins finden Sie im Dataverse-Thema Debuggen eines Plug-Ins. In den folgenden Schritten wird beschrieben, wie Sie ein Plug-In debuggen, das in Dynamics 365 Customer Engagement (on-premises) ausgeführt wird.
Hinweis
Eine alternative Methode zum Debuggen eines Plug-Ins, das in der Sandbox für einen beliebigen Bereitstellungstyp ausgeführt wird, ist die Verwendung des Protokollierungsdienstes. 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 Plug-ins.
Debuggen Sie ein Plug-In
Registrieren Sie die Plug-In-Assembly, und stellen Sie sie bereit.
Wenn eine andere Kopie der Assembly am selben Speicherort vorhanden ist und Sie diese Kopie nicht überschreiben können, da sie von Dynamics 365 Customer Engagement (on-premises) gesperrt ist, müssen Sie den Serviceprozess neu starten, der das Plug-In ausgeführt hat. In der folgenden Tabelle finden Sie den korrekten Serviceprozess. Weitere Informationen: Registrieren und Bereitstellen von Plug-Ins
Konfigurieren Sie den Debugger.
Fügen Sie den Debugger an den Prozess auf dem Dynamics 365 Server an, der Ihr Plug-In ausführt. In der folgenden Tabelle finden Sie eine Identifizierung des Prozesses.
Konfiguration der Plug-In-Registrierung Service-Prozess 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 Wenn mehrere Prozesse dieselbe ausführbare Datei ausführen, z. B. mehrere w3wp.exe Prozesse, fügen Sie den Debugger an alle Instanzen des ausgeführten ausführbaren Prozesses an. Legen Sie als Nächstes einen oder mehrere Haltepunkte in Ihrem Plug-In-Code fest.
Testen Sie das Plug-In.
Führen Sie die Dynamics 365 Customer Engagement-Anwendung (on-premises) oder eine andere benutzerdefinierte Anwendung aus, die das SDK verwendet, und führen Sie die erforderliche Aktion aus, damit das Plug-In ausgeführt wird. Wenn z. B. ein Plug-In für ein Kontoerstellungsereignis registriert ist, erstellen Sie ein neues Konto.
Debuggen Sie den Plug-In-Code.
Nehmen Sie alle erforderlichen Änderungen an Ihrem 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 in diesem Verfahren nach Bedarf. Wenn Sie jedoch die Haupt- oder Nebenversionsnummern der Plug-In-Assembly ändern, müssen Sie die Registrierung der früheren Version der Assembly aufheben und die neue Version registrieren. Weitere Informationen: Registrieren und Bereitstellen von Plug-Ins
Registrieren Sie das Plug-In in der Datenbank.
Nachdem der Bearbeitungs-/Kompilierungs-/Bereitstellungs-/Test-/Debugzyklus für Ihr Plug-In abgeschlossen wurde, heben Sie die Registrierung der Plug-In-Assembly (auf dem Datenträger oder GAC) auf, und registrieren Sie das Plug-In dann erneut in der Dynamics 365 Customer Engagement (on-premises)-Datenbank. Weitere Informationen: Registrieren und Bereitstellen von Plug-Ins
Tipp
Es ist möglich, ein in der Datenbank bereitgestelltes Plug-In zu debuggen. Die Symboldatei (PDB) der kompilierten Plug-In-Assembly muss in den Ordner crm-root>\Server\bin\assembly des < Servers kopiert werden, und die Internetinformationsdienste (IIS) müssen dann neu gestartet werden. Nachdem das Debuggen abgeschlossen ist, müssen Sie die Symboldatei entfernen und IIS zurücksetzen, um zu verhindern, dass der Prozess, der das Plug-In ausgeführt hat, zusätzlichen Arbeitsspeicher verbraucht.
Weitere Informationen zum Debuggen eines Plug-Ins mit dem Plug-In-Profiler-Tool finden Sie unter Debuggen eines Plug-Ins.
Debuggen eines Sandbox-Plug-Ins
Es ist wichtig, diese Schritte vor der ersten Ausführung eines Sandbox-Plug-ins durchzuführen. Wenn das Plug-In bereits ausgeführt wurde, ändern Sie entweder den Code der Assembly, wodurch sich der Hash der Assembly auf dem Server ändert, oder starten Sie den Dynamics 365 Customer Engagement (on-premises) Sandbox Processing Service auf dem Sandbox-Server neu.
Konfigurieren des lokalen Servers
Der Sandbox-Hostprozess überwacht den Sandbox-Arbeitsprozess, der das Plug-In ausführt. Der Hostprozess prüft, ob das Plug-In nicht mehr reagiert, ob es die Speicherschwellenwerte überschreitet und vieles mehr. 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 Funktion zum Herunterfahren zu deaktivieren, legen Sie den folgenden Registrierungsschlüssel auf 1 (DWORD
) fest:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM\SandboxDebugPlugins
Debuggen des Plug-Ins
Führen Sie die folgenden Schritte aus, um ein Sandbox-Plug-In zu debuggen.
Registrieren Sie das Plug-In in der Sandbox (Isolationsmodus) und stellen Sie es in der Dynamics 365 Server-Datenbank bereit.
Kopieren Sie die Symboldatei (.PDB) der kompilierten Plug-In-Assembly auf den Server\bin\assembly folder on the server running the sandbox worker process named Microsoft.Crm.Sandbox.WorkerProcess.exe. Dies ist der Server, auf dem die Rolle "Sandbox-Verarbeitungsdienst" gehostet wird.
Befolgen Sie die Anweisungen in den Schritten 2 bis 4 am Anfang dieses Themas.
Weitere Informationen zum Debuggen eines Plug-Ins mit dem Plug-In-Profiler-Tool finden Sie unter Debuggen eines Plug-Ins.
Siehe auch
Plug-in-Entwicklung
Debuggen Sie ein Plug-In
Registrieren und Bereitstellen von Plug-Ins
Schreiben eines Plug-Ins