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.
Da es sich bei benutzerdefinierten Workflowerweiterungen um .NET Framework-Assemblys handelt, können Sie diese mithilfe von Methoden debuggen, die dem Debuggen von Plug-Ins ähneln.
Verwenden des Plug-In-Registrierungstools
Das Plug-In-Registrierungstool (PRT) ist eines der Tools, die Sie von NuGet herunterladen können. Weitere Informationen: Dataverse-Entwicklungstools.
Nachdem Sie das PRT heruntergeladen haben, wählen Sie die PluginRegistration.exe Datei aus, um sie auszuführen.
Profiler installieren
Über das PRT können Sie die Plug-In-Profiler-Lösung installieren, indem Sie auf die Schaltfläche "Profiler installieren" klicken.
Diese Lösung fügt die Funktion zum Erfassen des Kontexts hinzu, der an Ihre Workflowaktivität übergeben wird, und ermöglicht die Wiedergabe, mit der Sie die Logik in Ihrem Code lokal mithilfe von Visual Studio debuggen können.
Wenn der Plug-In-Profiler für Ihre Microsoft Dataverse-Instanz installiert ist, wird es im PRT unten in der Liste der registrierten Plug-Ins und benutzerdefinierten Workflowaktivitäten angezeigt.
Profil einer Workflowaktivität
Um eine Workflowaktivität zu profilieren, klicken Sie mit der rechten Maustaste auf das Plug-In Profiler , und wählen Sie "Profilerstellungsworkflow starten" aus.
Das Dialogfeld "Profiler-Einstellungen" , das die folgenden Optionen bereitstellt:
| Feld | Description |
|---|---|
| Arbeitsablauf | Wählen Sie den Workflow aus, der die Workflowaktivität enthält, die Sie debuggen möchten. |
| Schritte | Wählen Sie die spezifischen Schritte innerhalb dieses Workflows aus, die Sie debuggen möchten. |
| Profilspeicher angeben | Wir empfehlen Ihnen, In Entität speichern zu wählen. |
| Festlegen von Profilereinstellungen | Wenn Sie mit einem System arbeiten, in dem der Workflow häufig ausgeführt wird, können Sie die Leistungseinbußen verringern, indem Sie die Anzahl der erfassten Profile einschränken. |
| Sichere Konfiguration einschließen | Dies bietet die Möglichkeit, die Anzeige potenziell vertraulicher Daten zu vermeiden, die möglicherweise als sichere Konfiguration übergeben werden. |
Klicken Sie auf OK, um die Einstellungen zu speichern.
Hinweis
Zum Zeitpunkt dieses Schreibvorgangs wird möglicherweise der folgende Fehler angezeigt:
Die Details dieses Fehlers umfassen die Meldung: Automatic workflow cannot be published if no activation parameters have been specified.
Die Profileinstellungen werden erfolgreich gespeichert. Dieser Fehler tritt auf, da der Prozess der Profilerstellung einer benutzerdefinierten Workflowaktivität eine Kopie des Workflows erstellt und sowohl den ursprünglichen Workflow als auch die Kopie deaktiviert. Sie müssen die Profilkopie neu konfigurieren und aktivieren, um ein Profil zu erfassen. Weitere Informationen finden Sie in den folgenden Schritten:
Erfassen eines Profils
Wenn ein Profil für Workflow mit einer benutzerdefinierten Workflowaktivität konfiguriert ist, wird eine Kopie des ursprünglichen Workflows erstellt, und der Text (Profiled) wird an den Namen angefügt. Sowohl das Original als auch die Kopie der Workflows werden deaktiviert.
Hinweis
Sofern Sie nicht in der Systemstandardlösung arbeiten, wird der kopierte Workflow möglicherweise nicht angezeigt, da er dieser Lösung hinzugefügt wird. Um den kopierten Workflow in der Projektmappe anzuzeigen, in der Sie arbeiten, müssen Sie "Vorhandene hinzufügen" auswählen und diese Kopie zu Ihrer Lösung hinzufügen.
Die deaktivierten Workflows sollten wie folgt aussehen:
Wenn der Workflow kopiert wird, gehen einige der Konfigurationen verloren. Wenn Sie versuchen, den kopierten Workflow zu aktivieren, wird die folgende Fehlermeldung angezeigt: An automatic process cannot be activated if no activation parameters have been specified. Add activation parameters, and then activate. ...
Dies bedeutet, dass Sie die Start when-Eigenschaften des Workflows neu konfigurieren müssen. In diesem Fall möchten wir festlegen, dass der Workflow gestartet wird, wenn sich das Feld "Kontoname " ändert:
Wählen Sie die Schaltfläche "Auswählen " aus, um das Feld " Kontoname " auszuwählen.
Der kopierte Profilworkflow wird in einen asynchronen Hintergrundworkflow geändert. Es ist einfacher, einen Echtzeitworkflow (synchron) zu testen. Wählen Sie daher in der Menüleiste "In Echtzeitworkflow konvertieren" aus.
Speichern Sie den kopierten Profilworkflow, und aktivieren Sie ihn.
Aktualisieren Sie in einer App, die mit Ihrer Dataverse-Instanz oder mithilfe der Webdienste verbunden ist, den Kontonamenwert einer Kontoentität. Diese Änderung initiiert die Erfassung der Kontextinstanz, die an Ihre benutzerdefinierte Workflowaktivität übergeben wurde, und speichert sie als Profildatensatz im System.
Tipp
Wenn Ihr Workflow asynchron ist, stellen Sie sicher, dass er abgeschlossen ist, bevor Sie mit dem nächsten Schritt fortfahren. Wechseln Sie zu "Einstellungen > "-Systemaufträge, und stellen Sie sicher, dass der Workflow erfolgreich war.
Stoppen Sie die Profilerstellung
Nachdem Sie das Profil erfasst haben, das Sie debuggen müssen, sollten Sie die Profilerstellung des Plug-Ins beenden.
Um die Profilerstellung zu beenden, heben Sie die Registrierung des Workflows mithilfe des PRT auf.
Dadurch wird die Kopie des erstellten Workflows gelöscht.
Von Bedeutung
Der kopierte Workflow wird weiterhin deaktiviert. Sie müssen sie manuell reaktivieren, wenn sie angewendet werden soll.
Debuggen der Assembly
Wählen Sie im PRT Plug-in-Ausführung wiedergeben aus.
Wählen Sie im Dialogfeld "Plug-In-Ausführung wiedergeben" auf der Registerkarte " Setup " die Schaltfläche "Herunterladen" aus, um ein Profil auszuwählen.
Hinweis
Die Registerkarten " Unsichere Konfiguration", "Sichere Konfiguration" und "Einstellungen " werden nicht für das Debuggen von Workflowaktivitäten verwendet. Sie werden nur für Plug-Ins verwendet.
Wählen Sie im Dialogfeld "Profil aus CRM auswählen" das neueste Profil aus, das das von Ihnen generierte Profil darstellt.
Hinweis
Sie können erfasste Profile in dynamics 365 – benutzerdefinierte Webanwendung verwalten, indem Sie zu ">>" navigieren.
Wählen Sie "Auswählen" aus, um das Dialogfeld zu schließen.
Wählen Sie im Feld "Assemblyspeicherort" die Ellipsenschaltfläche (...) aus, um den Speicherort der Assembly hinzuzufügen, die die Workflowaktivität enthält, die Sie debuggen.
Öffnen Sie Ihr Workflowaktivitätsprojekt in Visual Studio.
Fügen Sie einen Haltepunkt zu einer Zeile innerhalb der
Execute-Methode Ihrer Workflowaktivität hinzu.
Wählen Sie im Menü " Debuggen " die Option "An Prozess anhängen" aus.
Suchen Sie nach dem Prozess für
PluginRegistration.exe.Tipp
Der Suchfilter hilft Ihnen, dies schneller zu finden. Die dem Prozess zugewiesene Prozess-ID (PID) unterscheidet sich für jede Sitzung. Die PID wird im Dialogfeld "Plug-In-Ausführung erneut wiedergeben " unter "Plug-In-Ablaufverfolgungen" angezeigt.
Wählen Sie "Anfügen" aus, um den Visual Studio-Debugger an die PRT-Anwendung anzufügen, die zum Ausführen der Prozesswiedergabe dient.
Wählen Sie im Dialogfeld " Ausführung des PRT Replay Plug-Ins " die Schaltfläche " Ausführung starten" aus .
Sie sollten nun in der Lage sein, Ihren Code zu durchlaufen und Ihre Workflowaktivität mit Visual Studio zu debuggen.