Lernprogramm: Debuggen eines Plug-Ins

Dieses Lernprogramm ist das zweite in der Serie, in der Ihnen gezeigt wird, wie Sie mit Plug-Ins arbeiten.

• Lernprogramm: Schreiben und Registrieren eines Plugins
• Lernprogramm: Debuggen eines Plug-Ins (Dieses Lernprogramm)
• Lernprogramm: Aktualisieren eines Plug-Ins

Eine detaillierte Erläuterung der unterstützenden Konzepte und technischen Details finden Sie unter:

• Verwenden von Plug-Ins zur Erweiterung von Geschäftsprozessen
• Schreiben eines Plug-Ins
• Registrieren eines Plug-Ins
• Debuggen von Plug-Ins

Ziel

Da das Plug-In auf einem Remoteserver ausgeführt wird, können Sie dem Plug-In-Prozess keinen Debugger hinzufügen. Der Plug-in-Profiler erfasst ein Profil eines ausgeführten Plug-ins und lässt zu, dass Sie die Ausführung des Plug-ins mit Visual Studio auf Ihrem lokalen Computer nachspielen können.

Anforderungen

• Alle Voraussetzungen für Lernprogramm: Schreiben und Registrieren eines Plug-Ins gelten. Informationen unter 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 folgenden allgemeinen Schritte mit einem anderen registrierten Plug-In verwenden.

Plug-In-Profiler installieren

Es stehen zwei Tools zum Ausführen des Plug-In-Profilers zur Verfügung: das Plug-In-Registrierungstool und Power Platform Tools für Visual Studio. Anweisungen zur Verwendung beider Tools finden Sie in diesem Tutorial.

Plug-in Registration Tool

1. Wenn das Plug-in Registration Tool noch nicht installiert und geöffnet ist, folgen Sie den Schritten in Tutorial: 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. Klicken Sie im Plug-In-Registrierungstool auf Profiler installieren.

   

Power Platform Tools

1. Folgen Sie den Anweisungen in Power Platform Tools installieren.

Wenn Sie die oben aufgeführten Schritte ausführen, erhalten Sie eine neue verwaltete Lösung namens Plug-In-Profiler in Ihrer Microsoft Dataverse-Entwicklungsumgebung.

Profilierung starten

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

Plug-in Registration Tool

1. Wählen Sie im Tool „Plug-in-Registrierung“ den (Schritt) BasicPlugin.FollowupPlugin: Erstellen eines Kontos, den Sie zuvor registriert haben, und klicken Sie auf Start Profiling.

   

2. Wenn sich der Dialog Profiler-Einstellungen öffnet, übernehmen Sie die Standardeinstellungen und klicken Sie auf OK, um den Dialog zu schließen.

   

Tipp

Weitere Informationen zum Ausführen des mit dem Plug-In-Registrierungstool installierten Profilers finden Sie unter Den Plug-In-Profiler über ein Eingabeaufforderungsfenster ausführen.

Power Platform Tools

1. Wählen Sie in Visual Studio Ansicht > Power Platform-Explorer, um die Ansicht zu öffnen, sofern sie nicht bereits geöffnet ist.

2. Erweitern Sie den Knoten Plug-In-Assemblys und erweitern Sie dann den Assemblyknoten BasicPlugin.FollowupPlugin vollständig.

3. Klicken Sie mit der rechten Maustaste auf die Schrittregistrierung (den Knoten der niedrigsten Ebene) des Plug-Ins und wählen Sie Profilerstellung starten aus.

4. Wenn sich der Dialog Profiler-Einstellungen öffnet, übernehmen Sie die Standardeinstellungen und klicken Sie auf OK, um den Dialog zu schließen.

   

Erfassen eines Profils

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

Plug-in Registration Tool

1. Im Plug-In-Registrierungstool klicken Sie auf Debuggen

   

2. Klicken Sie im Dialog Plug-In-Ausführung wiederholen auf der Registerkarte Setup . Symbol zum Öffnen des Dialog Profil aus CRM auswählen.

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

   

Power Platform Tools

1. Klicken Sie im Projektmappenexplorer mit der rechten Maustaste auf die Plug-In-Klassendatei im Plug-In-Bibliotheksprojekt und wählen Sie Debuggen.

2. Klicken Sie im Dialog Plug-In-Ausführung wiederholen auf der Registerkarte Setup . Symbol zum Öffnen des Dialog Profil aus CRM auswählen.

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

   

Ihr Plug-In-debuggen

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

Plug-in Registration Tool

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.

   

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

   

3. In Ihrem Visual Studio-Projekt wählen Sie Debuggen > Zum Verarbeiten anfügen … aus.

   

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

   

   Hinweis

   Sie sollten sehen, dass das Plug-In-Registrierungstool jetzt im Debugmodus ausgeführt wird.

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

   

6. In Ihrem Visual Studio-Projekt sollten Sie sehen, dass der Code am zuvor festgelegten Haltepunkt angehalten wird.

   

7. Gehen Sie zum Debuggen durch Ihren Code.

Power Platform Tools

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.

   

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

   

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

   

4. In Ihrem Visual Studio-Projekt sollten Sie sehen, dass der Code am zuvor festgelegten Haltepunkt angehalten wird.

   

5. Gehen Sie zum Debuggen durch Ihren Code.

Stoppen Sie die Profilerstellung

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

Plug-in Registration Tool

1. Schließen Sie den Dialog Plug-In-Ausführung wiederholen

2. Im Plug-In-Registrierungstool klicken Sie auf Profilierung stoppen.

   

Power Platform Tools

1. Schließen Sie den Dialog Plug-In-Ausführung wiederholen

2. Klicken Sie in der Power Platform-Explorer-Ansicht mit der rechten Maustaste auf den Schrittregistrierungsknoten (niedrigste Ebene) der Plug-In-Assembly und wählen Sie Profilerstellung stoppen aus.

Nächste Schritte,

Weitere Informationen zu allgemeinen Optionen bei Plug-Ins finden Sie unter Lernprogramm: Ein Plug-In aktualisieren

Wenn Sie nicht beim nächsten Lernprogramm fortsetzen, sollten Sie die Registrierung der BasicPlugin-Assembly, die Sie in diesem Schritt erstellt haben, aufheben. Anweisungen finden Sie unter Registrierung der Assembly, des Plug-Ins und des Schritts aufheben.

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

Plug-in Registration Tool

Während es oft vorzuziehen ist, den Profiler interaktiv über das Plug-in-Registrierungswerkzeug auszuführen, kann der Profiler unabhängig vom Werkzeug über ein Eingabeaufforderungsfenster ausgeführt werden. Dies ist hilfreich, um das Plug-In-Profilprotokoll vom Dynamics 365-App-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-Registrierungstool erneut zu wiederholen und das Plug-In mithilfe von Visual Studio zu debuggen.

Vorgehensweise: 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.

Power Platform Tools

Der Plug-In-Profiler ist nicht als Befehlszeilentool von Power Platform Tools für Visual Studio aus verfügbar.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).