InvalidPluginExecutionExceptionException in Plugins und Workflow-Aktivitäten verwenden

Kategorie: Supportabilität, Benutzerfreundlichkeit

Wirkungspotential: Mittel

Symptome

Wenn ein synchrones Plug-in eine andere Ausnahme als InvalidPluginExecutionException an die Plattform zurückgibt, wird dem Benutzer in einem Power Apps Client das Fehlerdialogfeld mit der Meldung der Ausnahme Message und der Stapelverfolgung angezeigt. Dies bietet eine unfreundliche Benutzererfahrung in einer wahrscheinlich bereits frustrierenden Situation.

Wenn Sie InvalidPluginExecutionException verwenden, um den Vorgang absichtlich aufgrund eines Problems mit der Datenvalidierungslogik abzubrechen, sollten Sie dem Anwendungsbenutzer eine Anleitung geben, damit er das Problem beheben und fortfahren kann.

Wenn der Fehler unerwartet ist, wird dennoch empfohlen, die Ausnahme abzufangen, in einen InvalidPluginExecutionException zu konvertieren und dann eine neue Ausnahme auszulösen, damit Anwendungen eine benutzerfreundliche Fehlermeldung mit Anleitungen anzeigen können, damit ein Benutzer oder technisches Personal das Problem schnell erkennen kann.

Anleitung

Plug-Ins sollten nur eine InvalidPluginExecutionException zurückgeben, und zwar aus den folgenden Gründen:

• Zeigt dem Benutzer ein nützliches Meldungsfeld an
• Vermeiden von Event Log/Trace File Blähungen

Ein ausgelöstes InvalidPluginExecutionException wird mit einer freundlichen Nachricht und einem IsvAborted-Fehlercode an den Benutzer Aufrufer zurückgegeben. Fehler beim Abfangen und Konvertieren einer Ausnahme in eine InvalidPluginExecutionException führt zu einem IsvUnExpected-Fehlercode ohne freundliche Meldung für den Benutzer von einem Power Apps-Client.

Behandeln von Fehlern aus Funktionen, die in Plug-ins aufgerufen werden

Innerhalb Ihres Plug-ins werden Sie allgemein andere Funktionen aufrufen, um Code wiederzuverwenden. Wie Sie mit Fehlern in diesen Funktionen umgehen, ist sehr wichtig, da ein unbehandelter Fehler zum Absturz des worker-Prozesses führen kann. Dies führt nicht nur zum Abbruch Ihres Plug-ins, sondern kann auch alle gleichzeitig ausgeführten Plug-ins Ihrer Organisation beenden. Weitere Informationen: Fehler: Sandbox-Worker-Prozess abgestürzt

Problematische Muster

Warnung

Diese Muster sollten vermieden werden.

Verwenden Sie kein HTML in der Fehlermeldung.

Webanwendungen, die auf Dataverse-Daten zugreifen, sollten Fehlermeldungen in HTML codieren, bevor sie einem Benutzer angezeigt werden. Dadurch wird verhindert, dass der HTML-Code in Ihrer Nachricht wie beabsichtigt gerendert wird. Es wird nur der HTML-Code angezeigt.

Siehe auch

Abbrechen eines Vorgangs
Workflowaktivitäten debuggen

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).