Freigeben über

Behandlung von Ausnahmen in Plug-ins

  • Artikel

 

Veröffentlicht: Januar 2017

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

Für synchrone Plug-Ins, ob in der Sandbox registriert oder nicht, behandelt die Microsoft Dynamics 365-Plattform von einem Plug-in zurückgegebene Ausnahmen durch Anzeige einer Fehlermeldung in einem Dialogfeld der Oberfläche der Webanwendung. Die Ausnahmemeldung für asynchrone registrierte Plug-Ins wird einem Datensatz des Systemauftrags (AsyncOperation) geschrieben, der im Systemauftragsbereich der Webanwendung angezeigt werden kann.

Für synchrone Plug-Ins können Sie optional eine benutzerdefinierte Fehlermeldung im Fehlerdialogfeld der Webanwendung anzeigen, indem Sie Ihr Plug-in dazu bringen, eine InvalidPluginExecutionException-Ausnahme mit der benutzerdefinierten Ausnahmezeichenfolge als Message -Eigenschaftswert auszugeben. Wenn Sie InvalidPluginExecutionException ausgeben und keine benutzerdefinierte Meldung angeben, wird in dem Fehlerdialogfeld eine allgemeine Standardmeldung angezeigt. Es wird empfohlen, dass Plug-Ins nur eine InvalidPluginExecutionException an die Plattform zurückgeben.

Falls ein synchrones Plug-In eine andere Ausnahme als InvalidPluginExecutionException an die Plattform zurückgibt, wird das Fehlerdialogfeld dem Benutzer angezeigt, und die Ausnahmemeldung (System.Exception.Message) mit Stack Trace wird an einem von zwei Orten geschrieben. Für Plug-Ins, die nicht in der Sandbox registriert sind, werden die Informationen in das Anwendungsereignisprotokoll auf dem Server geschrieben, auf dem das Plug-in ausgeführt wird. Das Ereignisprotokolls kann angezeigt werden, indem das Verwaltungstool Event Viewer verwendet wird. Für Plug-Ins, die in der Sandbox registriert sind, wird die Ausnahmemeldung und Stack Trace in den Microsoft Dynamics 365-Plattformtrace geschrieben. Weitere Informationen zum Tracing finden Sie im Abschnitt zu Protokollierung und Tracing des Themas Debuggen Sie ein Plug-In.

Siehe auch

Plug-In-Entwicklung
Daten zwischen Plug-Ins übergeben
Schreiben eines Plug-Ins
Debuggen Sie ein Plug-In
Behandlung von Ausnahmen in Ihrem Code

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright