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

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

Potentiel d’impact : Moyen

Symptômes

Si un plug-in synchrone renvoie une exception autre que InvalidPluginExecutionException à la plateforme, dans un client Power Apps une erreur s’affiche pour l’utilisateur avec le message d’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 et de la convertir en une InvalidPluginExecutionException, puis de lever une 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 et de la conversion d’une exception en une InvalidPluginExecutionException entraînera 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

Dans votre plug-in, vous appellerez généralement d’autres fonctions pour réutiliser le code. La manière dont vous gérez les erreurs dans ces fonctions est très importante, car une erreur non gérée peut provoquer le blocage du processus de travail. Cela met non seulement 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

Avertissement

Ces schémas doivent être évités.

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. Cela empêchera tout code HTML de votre message de s’afficher comme vous le souhaitez. Il affichera simplement le code HTML.

Voir aussi

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

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).