Utilisation d’InvalidPluginExecutionException dans les plug-ins et les activités de workflow

Catégorie : Capacité de prise en charge, convivialité

Impact potentiel : Moyen

Symptômes

Si un plug-in synchrone renvoie une exception autre que InvalidPluginExecutionException à la plateforme, un client Power Apps affiche une erreur à l’utilisateur avec le message de l’exception Message et la trace de la pile. Cela fournit une expérience utilisateur non conviviale dans ce qui est vraisemblable déjà une situation frustrante.

Si vous utilisez InvalidPluginExecutionException pour annuler intentionnellement l’opération en raison d’un problème de logique de validation des données, vous devez fournir des conseils applicables à l’utilisateur de l’application afin qu’il puisse corriger le problème et continuer.

Si l’erreur est inattendue, il est toujours recommandé de détecter l’exception, de la convertir en InvalidPluginExecutionException, puis de déclencher la nouvelle exception afin que les applications puissent afficher un message d’erreur convivial avec des conseils pour aider un utilisateur ou le personnel technique à identifier rapidement le problème.

Recommandation

Les plug-ins ne doivent renvoyer qu’une InvalidPluginExecutionException pour les raisons suivantes :

• Afficher un message utile à l’utilisateur
• Empêcher un ballonnement du journal des événements/fichier de suivi

Une InvalidPluginExecutionException levée revient à l’appelant avec un message convivial et un code d’erreur IsvAborted. L’échec de la détection ou de la conversion d’une exception en InvalidPluginExecutionException génère un code d’erreur IsvUnExpected sans message convivial affiché à l’utilisateur à partir d’un client Power Apps.

Gérer les erreurs des fonctions appelées dans les plug-ins

Les plug-ins appellent généralement d’autres fonctions pour réutiliser le code. La manière dont vous gérez les erreurs dans ces fonctions est importante, car une erreur non gérée peut provoquer le blocage du processus de travail. Ce processus de travail qui se bloque non seulement met fin à votre plug-in, mais peut également mettre fin à tous les plug-ins simultanés en cours d’exécution pour votre organisation. Plus d’informations : Erreur : le processus Sandbox Worker a échoué

Schémas problématiques

N’utilisez pas HTML dans le texte du message d’erreur.

Les applications web qui accèdent aux données Dataverse doivent encoder en HTML tout texte de message d’erreur avant de l’afficher à un utilisateur. Cet encodage empêche tout HTML dans votre message de s’afficher comme vous le souhaitez. Il affiche simplement le code HTML.

Voir aussi

Annulation d’une opération
Déboguer des activités de workflow