Gérer les exceptions dans les plug-ins

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Pour les plug-ins synchrones, inscrits ou non dans le bac à sable, la plateforme Microsoft Dynamics 365 gère les exceptions retournées par un plug-in en affichant un message d’erreur dans une boîte de dialogue de l’interface utilisateur de l’application Web. Le message d’exception pour les plug-ins inscrits de manière asynchrone est écrit dans un enregistrement de tâche système (AsyncOperation) pouvant être consulté dans la zone Tâches système de l’application Web.

Pour les plug-ins synchrones, vous pouvez également afficher un message d’erreur personnalisé dans la boîte de dialogue d’erreur de l’application Web, en demandant à votre plug-in de lever une exception InvalidPluginExecutionException, la chaîne du message personnalisé étant la valeur de la propriété Message de l’exception. Si vous levez InvalidPluginExecutionException sans fournir de message personnalisé, un message par défaut générique s’affiche dans la boîte de dialogue d’erreur. Il est préférable que les plug-ins transmettent uniquement une InvalidPluginExecutionException à la plateforme.

Si un plug-in synchrone renvoie une exception autre que InvalidPluginExecutionException à la plateforme, la boîte de dialogue d’erreur s’affiche pour l’utilisateur et le message d’exception (System.Exception.Message) est également inscrit à l’un de deux emplacements avec la trace de la pile. Pour les plug-ins non inscrits dans le bac à sable, les informations sont écrites dans le journal des événements d’application sur le serveur qui exécute le plug-in. Le journal des événements peut être consulté à l’aide de l’outil d’administration Observateur d’événements. Pour les plug-ins inscrits dans le bac à sable, le message d’exception et la trace de la pile sont écrits dans la trace de la plateforme Microsoft Dynamics 365. Pour plus d’informations sur le traçage, voir la section Enregistrement et traçage de la rubrique Déboguer un plug-in.

Voir aussi

Développement de plug-ins
Passer des données entre les plug-ins
Écrire un plug-in
Déboguer un plug-in
Gérer les exceptions dans votre code

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright