Développement de plug-in local

Article
03/22/2023

Un plug-in est une logique métier (code) personnalisée que vous pouvez intégrer avec Dynamics 365 Customer Engagement (on-premises) pour modifier ou améliorer le comportement standard de la plateforme. Une autre méthode d’exploiter les plug-ins est qu’ils sont des gestionnaires d’événements déclenchés par Dynamics 365 Customer Engagement (on-premises). Vous pouvez abonner ou inscrire un plug-in à un jeu d’événements connus pour que votre code s’exécute lorsque l’événement se produit.

Pour plus d’informations sur l’exécution de plug-in, voir Infrastructure d’événements.

Note

La documentation qui suit décrit des options supplémentaires uniquement disponibles dans les environnements locaux. Pour des informations générales sur l’écriture de plug-ins qui fonctionnent pour les déploiements locaux et en ligne, lisez la rubrique Utiliser des plug-ins pour étendre les processus métier dans la documentation sur Dataverse.

Bonnes pratiques pour le développement de plug-in sur site

Cette section inclut les bonnes pratiques propres au développement de plug-in sur site.

Cette section ne dépend pas des références aux variables transmises aux plug-ins.

Dans un environnement local où des plug-ins validés sont exécutés dans le même domaine d’application, ne vous attendez pas à une variable qui fait référence aux données incluses dans le contexte plug-in conserve une référence à l’objet.

Lorsque les données sont transmises dans le pipeline d’événements, elles sont sérialisées et désérialisées pour créer de nouvelles instances d’objet. Les instances d’objet ne correspondent pas à la même adresse en mémoire. Tout changement apporté à l’objet dans le pipeline d’exécution des plug-ins ne sera pas reflété dans l’instance d’objet transmise dans une opération du pipeline.

Par exemple, si vous définissez une QueryExpression incluse dans une RetrieveMultipleRequest, s’il existe un code dans un plug-in qui modifie la QueryExpression, cette modification ne se répercutera pas sur la variable d’instance d’origine QueryExpression qui a été transmise avec la demande RetrieveMultiple. Dans le pipeline, les propriétés de l’objet QueryExpression peuvent être mises à jour dans le processus de récupération des données. Par exemple, la propriété QueryExpression.PageInfo sera mise à jour dans le cadre de l’exécution de la requête. Vous ne pourrez pas détecter ces modifications en examinant la variable d’origine QueryExpression utilisée avec la RetrieveMultipleRequest.