Teilen über

Analysieren von Plug-In-Leistung

  • Artikel

 

Veröffentlicht: Januar 2017

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

Plug-in Profiler ist ein Tool, das die Ausführung von Plug-Ins und benutzerdefinierten Workflowaktivitäten für eine verbesserte Debugging-Umgebung in Microsoft Visual Studio profiliert. Dieses Tool, das aus dem Eingabeaufforderung oder innerhalb des Plug-in Registration-Tools ausgeführt werden kann, macht die Entwicklung benutzerdefinierten Codes für Microsoft Dynamics 365 (online und lokal) schneller und einfacher. Darüber hinaus können Benutzer die Ausführung von fehlerhaftem Code profilieren und die Ergebnisse an den Entwickler des Codes oder um einen unabhängigen Softwarehersteller (ISV) für Analysezwecke senden. Der Entwickler kann die Ausführung des Plug-Ins oder des benutzedefinierten Codes zurückspielen und den Code remote debuggen, auch wenn er keine Verbindung zum Microsoft Dynamics 365-Server hat.

Das Tool kann entweder im Modus "Debuggen" oder im Wiederholungsmodus verwendet werden. Die einzelnen Modi werden in den nachfolgenden Abschnitten beschrieben.

In diesem Thema

Debuggen eines Plug-In mithilfe des Plug-In-Profilers

Wiederholung der Plug-in-Ausführung

Den Plug-In-Profiler eigenständig ausführen

Debuggen eines Plug-In mithilfe des Plug-In-Profilers

  1. Führen Sie das Plug-in Registration-Tool aus. Sie können die ausführbare Datei des Tools im Tools\PluginRegistration Ordner des SDK finden.Laden Sie das Microsoft Dynamics CRM SDK-Paket herunter.

  2. Klicken Sie auf NEUE VERBINDUNG ERSTELLEN, um die Verbindung mit einem Microsoft Dynamics 365-Server und Organisation herzustellen. Weitere Informationen zur Verbindung mit einem Server und einer Organisation finden Sie im SDK-Thema: Exemplarische Vorgehensweise: Registrieren eines Plug-Ins mithilfe des Plug-In-Registrierungstools.

  3. Registrieren Sie ein Plug-In und Schritt auf dem Microsoft Dynamics 365-Server. Behalten Sie eine Kopie der kompilierten Plug-In-Assembly "Debuggen" auf dem Computer, auf dem Sie das Tool ausführen.

  4. In der Symbolleiste für der Zielorganisation, wählen Sie Profiler installieren aus. Sie sehen jetzt ein Knoten Plug-In-Profiler in der Liste.

  5. Wählen Sie einen Plug-In Schritt und klicken Sie auf der Symbolleiste auf Profil erstellen, um die Profilerstellung zu beginnen. Sie können im angezeigten Dialogfeld Profiler-Einstellungen festlegen, wie der Profiler ausgeführt wird.

  6. Führen Sie den Vorgang in Microsoft Dynamics 365 aus, der veranlasst, dass das Plug-In ausgeführt wird. Wenn der Schritt beispielsweise für ein Update eines Kontos konfiguriert ist, aktualisieren Sie ein Konto.

  7. Wenn Sie die Option Ausnahme im Dialogfeld Profiler-Einstellungen ausgewählt haben, nachdem das Plug-In eine Ausnahme ausgelöst hat und das Dialogfeld Geschäftsprozessfehler angezeigt wird, klicken Sie auf Protokolldatei herunterladen und speichern Sie diese Datei. Wenn das Plug-In keine Ausnahme auslöst, klicken Sie alternativ auf Profilerstellung beenden.

  8. Klicken Sie im Plug-in Registration-Tool auf Debuggen.

  9. Stellen Sie im Dialogfeld Vorhandenes Plug-In debuggen die angeforderten Informationen in der Registerkarte Setup bereit. Geben Sie die Position der zuvor gespeicherten Protokolldatei im Feld Profil ein. Geben Sie den Speicherort der Plug-In-Assembly und den Klassennamen des Plug-Ins an, das ausgeführt wurde, bzw. wählen Sie diese aus.

  10. Start Sie Microsoft Visual Studio, und fügen Sie dem PluginRegistration.exe-Prozess den Debugger an.

  11. Legen Sie einen Haltepunkt im Plug-In-Code fest.

  12. Klicken Sie auf Ausführung beginnen im Dialogfeld Vorhandenes Plug-In debuggen.

  13. Nach einer geringfügigen Verzögerung wird das Plug-In mit demselben Ausführungskontext ausgeführt, der ihm vom Microsoft Dynamics 365-Server übergeben wurde, und der Debugger beendet die Ausführung an dem Haltepunkt, den Sie zuvor festgelegt haben.

  14. Setzen Sie das Debuggen des Plug-Ins fort, wie Sie es normalerweise tun würden. Alle Ablaufverfolgungen, die das Plug-In ausgibt, werden im Dialogfeld Vorhandenes Plug-In debuggen angezeigt.

An dieser Stelle können Sie den Plug-In-Code ändern, erstellen, den debugger erneut dem PluginRegistration.exe-Prozess anfügen, und auf Ausführung beginnen klicken, um mit der Debugsitzung fortzufahren. Beim Ausführen dieser Vorgänge müssen Sie das Formular Vorhandenes Plug-In debuggen nicht schließen.

Sie müssen das Plug-In nicht erneut dem Microsoft Dynamics 365-Server bereitstellen, bis Sie das Codeproblem behoben haben. Dieses Debuggingsszenario funktioniert auch, wenn Sie über eine optimierte Version von Plug-Ins auf dem Server und eine Debugversion von Plug-Ins auf dem Computer verfügen, auf dem Sie debuggen.

Wiederholung der Plug-in-Ausführung

Das Wiederholen der Plug-In-Ausführ erfordert keine Verbindung zu einem Microsoft Dynamics 365-Server und -Organisation. Der Vorteil dieser Methode liegt darin, dass Sie das Plug-In-Ausführungsprofil von einem Kunden erhalten und das Plug-In remote debuggen können. Eine Einschränkung der Wiederholungsfunktion ist, dass Sie die Reihenfolge der Aufrufe nicht ändern können, die Ihr Plug-In-Code im Debugger vornimmt, während Sie debuggen.

Die Wiederholungsfunktion versieht das Plug-In mit einer Momentaufnahme der Aufrufdaten und des Ereignisausführungskontexts vom Microsoft Dynamics 365-Server. Sie erhalten die gleichen GUIDs, Ereignisse, usw. von Anrufen beim Organisationsservice, aber es werden keine Daten auf dem Server geändert, während Sie das Plug-In debuggen. Während des Debuggingsvorgangs im vorherigen Abschnitt stellt das Plug-In tatsächlich eine Verbindung mit dem Server her und tätigt Anrufe in Echtzeit.

Wiederholung der Plug-in-Ausführung

  1. Start Sie Microsoft Visual Studio, und fügen Sie dem PluginRegistration.exe-Prozess den Debugger an.

  2. Klicken Sie auf PLUG-IN-AUSFÜHRUNG WIEDERHOLEN.

  3. Geben Sie den Speicherort des Protokolls und der Plug-In-Assembly im Dialogfeld ein.

  4. Klicken Sie auf Ausführung beginnen.

  5. Debuggen Sie das Plug-In, wie Sie es normalerweise tun würden.

Den Plug-In-Profiler eigenständig ausführen

Der Profiler kann von einem Eingabeaufforderungsfenster unabhängigen unabhängig vom Plug-in Registration-Tool ausgeführt werden. Dies ist hilfreich, um das Plug-In-Profilprotokoll vom Microsoft Dynamics 365-Server eines Kunden zu erhalten, um ein fehlerhaftes Plug-In zu debuggen. Ein Entwickler kann dann diesen Datensatz verwenden, um die Ausführung von Plug-Ins im Plug-in Registration-Tool erneut zu wiederholen und das Plug-In mithilfe von Microsoft Visual Studio zu debuggen.

Ausführen des Plug-In-Profilers von einer Eingabeaufforderung aus

  1. Öffnen Sie ein Eingabeaufforderungsfenster und legen Sie das Arbeitsverzeichnis zum Tools\PluginRegistrations-Ordner im SDK-Download fest.

  2. Geben Sie den Befehl ein: PluginProfiler.Debugger.exe /?.

  3. Überprüfen Sie die Liste der unterstützten Parameterliste und führen Sie das PluginProfiler.Debugger.exe-Programm mit den entsprechenden Parametern erneut aus.

Siehe auch

Entwicklertools
Lösungstools für die Teamentwicklung
Plug-In-Entwicklung
Registrieren und Bereitstellen von Plug-Ins
Debuggen Sie ein Plug-In

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright