Dataverse plug-in
Concept
Code personnalisé côté serveur enregistré dans le pipeline d'événements de Dataverse, qui s'exécute lors des opérations sur les données et sert dans Dynamics 365 à la validation transactionnelle et aux calculs.
Également abordés
Les épisodes consacrés à Dataverse plug-in abordent aussi Saga pattern, Transactional outbox pattern, Database normalization, Dataverse business skills, Dataverse business units et PSDataverse.
Description
Un plug-in Dataverse est un gestionnaire d'événements personnalisé qui réagit à un événement précis pendant le traitement d'une opération sur les données dans Microsoft Dataverse. Il s'écrit sous la forme d'une classe dans un assembly .NET Framework, puis cet assembly est enregistré dans Dataverse. Un même assembly peut contenir plusieurs classes, chacune enregistrée à une étape différente du framework d'événements. Dans Dynamics 365, les plug-ins servent à la logique côté serveur, comme la validation transactionnelle et les calculs, qui doivent s'exécuter lors de la création, de la mise à jour ou d'un autre traitement de données.
Chaque classe de plug-in implémente l'interface IPlugin, qui définit une seule méthode Execute. Lorsque l'événement enregistré se produit, Dataverse appelle cette méthode et lui transmet des données de contexte sur l'opération traitée. Le code peut alors annuler l'opération en cours dans le pipeline, modifier les données métier traitées, lancer d'autres opérations sur les données, contacter des systèmes externes ou transmettre des informations aux plug-ins suivants du même pipeline. Les plug-ins peuvent s'exécuter de manière synchrone, auquel cas l'opération attend leur fin, ou de manière asynchrone une fois l'opération terminée.
Le choix entre ces modes a des conséquences concrètes. La logique qui doit empêcher l'enregistrement de données incorrectes relève de la partie synchrone du pipeline, tandis que le travail pouvant intervenir après l'enregistrement peut s'exécuter de manière asynchrone. Microsoft Learn indique que les plug-ins synchrones doivent s'exécuter rapidement et que l'exécution est soumise à une limite de temps stricte. Un code mal écrit peut aussi dégrader les performances, et la création de plug-ins exige des compétences de développeur, ce qui a un coût que les options déclaratives n'ont pas.
En raison de ces inconvénients, la documentation Microsoft conseille d'examiner d'abord les options déclaratives. Parmi les alternatives citées figurent les actions personnalisées, les colonnes calculées et de rollup, les webhooks et Power Automate. Un plug-in devient l'outil approprié lorsque ces options ne couvrent pas le besoin, par exemple lorsque la logique doit être appliquée au sein même de la transaction.
L'épisode de M365.FM « Customize Dataverse for Complex Business Apps » place le plug-in Dataverse dans une matrice de décision pour les règles métier. Selon cet épisode, les questions se présentent à peu près ainsi : si une règle doit bloquer les données incorrectes, utiliser une logique serveur synchrone ; si elle peut s'exécuter après l'enregistrement, utiliser une logique serveur asynchrone ; pour la messagerie inter-applications ou les approbations, utiliser Flow ou Teams ; et pour les calculs lourds ou les jointures complexes, utiliser un plug-in Dataverse ou un Dataflow. L'épisode recommande également de tenir un catalogue de règles qui consigne la table, le déclencheur, la condition, l'action et le propriétaire de chaque règle, et conseille d'utiliser les champs calculés et de rollup pour les calculs déterministes et les sommes sur des enregistrements liés plutôt que de recourir au code.
L'épisode « Why Power Platform Is Your Real Automation Layer — Not Custom Code » aborde le même sujet sous l'angle de l'historique des personnalisations. Il décrit le modèle traditionnel de Dynamics, dans lequel chaque écart entre l'application standard et le processus métier devient une nouvelle personnalisation : un plug-in Dataverse, du JavaScript attaché à un formulaire, une activité de workflow personnalisée, une tâche planifiée ou un autre service d'intégration. Selon l'épisode, chaque fonctionnalité peut fonctionner correctement isolément, mais le processus complet se répartit peu à peu entre des assemblies, des scripts, des workflows, des API, des valeurs de configuration et des connaissances de spécialistes. Ainsi, le responsable du processus comprend la politique mais ne peut pas inspecter sa mise en œuvre. C'est le principal argument pour considérer les plug-ins comme un choix délibéré plutôt que comme une réponse par défaut à chaque évolution d'un processus.
Aperçu compilé avec l'IA à partir des épisodes M365.FM et des informations de cette page. Tu peux l'améliorer avec le bouton de modification ci-dessous.
| Type | Concept |
|---|
Questions fréquentes
Les questions marquées IA ont été rédigées avec l'IA à partir des informations de cette page.
Qu'est-ce qu'un plug-in Dataverse ? (IA)
Un plug-in Dataverse est un gestionnaire d'événements personnalisé, écrit sous la forme d'une classe dans un assembly .NET Framework et enregistré dans Dataverse, qui s'exécute en réponse à un événement précis pendant une opération sur les données. Chaque classe implémente l'interface IPlugin avec une seule méthode Execute.
Un plug-in Dataverse peut-il s'exécuter de manière synchrone et asynchrone ? (IA)
Oui. Les plug-ins peuvent s'exécuter de manière synchrone, auquel cas l'opération attend leur fin, ou de manière asynchrone une fois l'opération terminée. Microsoft Learn indique que les plug-ins synchrones doivent s'exécuter rapidement et que l'exécution est soumise à une limite de temps stricte.
Quand faut-il utiliser un plug-in Dataverse plutôt que d'autres options ? (IA)
Microsoft Learn conseille d'examiner d'abord les options déclaratives, comme les actions personnalisées, les colonnes calculées et de rollup, les webhooks et Power Automate. L'épisode « Customize Dataverse for Complex Business Apps » suggère un plug-in ou un Dataflow pour les calculs lourds ou les jointures complexes.
Community wiki
Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.
Experts et entreprises pour ce sujet
Personne n'a encore indiqué ce sujet. Ajoutez-le à votre profil.
Maintenu par Mirko Peters (Microsoft MVP) · Dernière mise à jour: