Freigeben über

Lernprogramm: Debuggen eines Plug-Ins

In diesem Lernprogramm erfahren Sie, wie Sie ein Plug-In in Microsoft Dataverse mithilfe von Plug-In Profiler debuggen. Verwenden Sie sie zum Wiedergeben der Ausführung in Visual Studio und zur schnelleren Problembehandlung.

Ausführliche Erläuterungen zu unterstützenden Konzepten und technischen Details finden Sie unter:

Ziel

Da das Plug-In auf einem Remoteserver ausgeführt wird, können Sie keinen Debugger an den Plug-In-Prozess anfügen. Der Plug-In-Profiler erfasst ein Profil eines ausgeführten Plug-Ins und ermöglicht es Ihnen, die Ausführung des Plug-Ins mithilfe von Visual Studio auf Ihrem lokalen Computer wiederzuverwenden.

Anforderungen

  • Alle Voraussetzungen für Tutorial: Schreiben und Registrieren eines Plug-Ins gelten. Siehe Voraussetzungen. Die Ausnahme ist, dass Sie mindestens Visual Studio 2019 benötigen, um Power Platform Tools zu installieren und zu nutzen.
  • Wenn Sie das vorherige Lernprogramm nicht abgeschlossen haben, können Sie die allgemeinen Schritte in diesem Lernprogramm mit einem anderen registrierten Plug-In verwenden.

Plug-In-Profiler installieren

Sie können das Plug-In Profiler über zwei Tools ausführen: das Plug-In-Registrierungstool und Power Platform Tools für Visual Studio. Dieses Lernprogramm enthält Anweisungen für die Verwendung beider Tools.

  1. Wenn Sie das Plug-In-Registrierungstool noch nicht installiert und geöffnet haben, führen Sie die Schritte im Lernprogramm aus: Schreiben und Registrieren eines Plug-Ins , um es zu öffnen. Schließen Sie den Abschnitt Herstellen einer Verbindung mit dem Plug-In-Registrierungstool ab.

  2. Wählen Sie im Plug-In-Registrierungstool die Option "Profiler installieren" aus.

    Screenshot des Plug-In-Registrierungstools mit ausgewählter Option

Wenn Sie die vorstehenden Schritte ausführen, fügen Sie Ihrer Microsoft Dataverse-Entwicklungsumgebung eine neue verwaltete Lösung namens Plug-In Profiler hinzu.

Profilierung starten

Führen Sie diese Schritte aus, um mit der Profilerstellung für die Ausführung eines Plug-Ins zu beginnen.

  1. Wählen Sie im Plug-In-Registrierungstool den (Schritt) BasicPlugin.FollowupPlugin: Erstellen von Konto-Schritt, den Sie zuvor registriert haben, und wählen Sie Profilerstellung starten aus.

    Screenshot eines Plug-In-Schritts, der im Plug-In-Registrierungstool mit dem Befehl „Profiling starten“ verfügbar ist.

  2. Wenn das Dialogfeld "Profiler-Einstellungen " angezeigt wird, akzeptieren Sie die Standardeinstellungen, und wählen Sie "OK" aus.

    Profilereinstellungen.

Tipp

Alternative Informationen zum Ausführen des profilers, der mit dem Plug-In-Registrierungstool installiert wurde, finden Sie unter Ausführen des Plug-In-Profilers über ein Eingabeaufforderungsfenster.

Erfassen eines Profils

Erstellen Sie in Ihrer modellgesteuerten (oder anderen) App ein neues Konto, um das Plug-In auszuführen. Diese Aktion erfasst eine Instanz des Ausgeführten Plug-Ins und speichert sie als Plug-In-Profil-Tabellenzeile in Dataverse. Sie können diese Zeile in Power Apps unter Tabellen>Plug-In-Profil sehen, indem Sie Daten auswählen.

  1. Wählen Sie im Plug-In-Registrierungstool "Debuggen" aus.

    Auf „Debuggen“ klicken.

  2. Wählen Sie im Dialogfeld Plug-In-Ausführung wiedergeben auf der Registerkarte Setup das Symbol Befehl aus, um das Dialogfeld Profil aus CRM auswählen zu öffnen.

  3. Wählen Sie im Dialogfeld Profil von CRM auswählen das Profil aus, in dem TypnameBasicPlugin.FollowupPlugin entspricht und das aufgezeichnete Profil darstellt wird, als Sie das Plug-In zuletzt starteten.

    Wählen Sie im CRM-Dialog „Profil“ aus.

Das Plug-in debuggen

Führen Sie die folgenden Schritte aus, um Ihren Plug-In-Code zu debuggen.

  1. Im Dialogfeld Plug-In-Ausführung wiederholen auf der Registerkarte Setup im Abschnitt Assembly angeben klicken Sie auf die Schaltfläche mit den Auslassungspunkten (…) und wählen den Speicherort Ihrer BasicPlugin.dllaus.

    Plug-in-Ausführung wiederholen.

  2. Legen Sie in Ihrem Visual Studio-Projekt einen Haltepunkt in Ihrer Plug-In-Klasse fest.

    Festlegen eines Haltepunktes.

  3. In Ihrem Visual Studio-Projekt wählen Sie Debug>An Prozess anhängen… aus.

    Befehl „Zum Verarbeiten anfügen“.

  4. Wählen Sie den Prozess PluginRegistration.exe aus, und klicken Sie auf Anfügen.

    Dialogfenster „An Prozess anhängen“.

    Anmerkung

    Das Plug-In-Registrierungstool wird jetzt im Debugmodus ausgeführt.

  5. Klicken Sie im Dialogfeld Plug-In-Ausführung wiederholen auf Ausführung beginnen.

    Ausführung beginnen.

  6. In Ihrem Visual Studio-Projekt wird der Code an dem Haltepunkt angehalten, den Sie zuvor festgelegt haben.

    Haltepunkt erreicht.

  7. Gehen Sie schrittweise durch Ihren Code, um zu debuggen.

Stoppen Sie die Profilerstellung

Führen Sie diese Schritte aus, um die Profilerstellung für die Ausführung eines Plug-Ins zu beenden.

  1. Schließen Sie das Dialogfeld "Plug-In-Ausführung erneut wiedergeben ".

  2. Wählen Sie im Plug-In-Registrierungstool die Option "Profilerstellung beenden" aus.

    Stoppen Sie die Profilerstellung.

Nächste Schritte,

Weitere Informationen zu den üblichen Aufgaben, die Sie mit Plug-Ins ausführen, erhalten Sie im Tutorial: Ein Plug-In aktualisieren.

Wenn Sie nicht beabsichtigen, mit dem nächsten Lernprogramm fortzufahren, heben Sie die Registrierung der basicPlugin-Assembly auf, die Sie in diesem Schritt erstellt haben. Anweisungen finden Sie unter Assembly, Plug-In und Schritt aufheben.

Starten Sie den Plug-in-Profiler über ein Eingabeaufforderungsfenster.

Obwohl es häufig besser ist, den Profiler interaktiv über das Plug-In-Registrierungstool auszuführen, können Sie den Profiler über ein Eingabeaufforderungsfenster unabhängig vom Tool ausführen. Diese Methode ist nützlich, um das Plug-In-Profilprotokoll vom Dynamics 365-Apps-Server eines Kunden abzurufen, um ein fehlgeschlagenes Plug-In zu debuggen. Ein Entwickler kann dieses Protokoll verwenden, um die Ausführung des Plug-Ins im Plug-In-Registrierungstool wiederzuverwenden und das Plug-In mithilfe von Visual Studio zu debuggen.

Prozedur: Ausführen des Plug-In-Profilers über eine Eingabeaufforderung

  1. Öffnen Sie ein Eingabeaufforderungsfenster und legen Sie das Arbeitsverzeichnis auf den Ordner fest, in dem Sie das Plug-in-Registrierungswerkzeug PluginRegistration.exe heruntergeladen haben.
  2. Geben Sie diesen Befehl ein, um die verfügbaren Laufzeitparameter anzuzeigen: 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.
  • Last updated on