Inscrire un plug-in à déployer sur site

Les plug-ins et les activités de flux de travail personnalisées sont du code personnalisé que vous développez pour étendre les fonctionnalités existantes de Dynamics 365 Customer Engagement (sur site). Avant qu’un plug-in ou une activité de flux de travail personnalisé puisse être utilisé, il doit être enregistré auprès du serveur. Un plug-in et un outil d’enregistrement d’activité de flux de travail personnalisé sont disponibles en téléchargement.

Des informations générales sur l’enregistrement du plug-in et de l’assembly de flux de travail personnalisé sont disponibles dans les rubriques Dataverse Inscrire un plug-in et Inscrire votre assembly. Les informations ci-dessous sont spécifiques au développement de plug-ins locaux.

Bien que cette rubrique se concentre principalement sur les plug-ins, la plupart des informations s’appliquent également aux activités de flux de travail personnalisées. L'une des différences entre les deux est que pour les assemblages d'activités de flux de travail personnalisées, vous enregistrez uniquement l'assemblage. Pour les plug-ins, vous enregistrez l’ensemble du plug-in et une ou plusieurs étapes par plug-in. Pour plus d’informations sur les activités de flux de travail personnalisé, consultez Activités de flux de travail personnalisées (assemblages de flux de travail).

Stockage modulaire

Pour un déploiement sur site, les plug-ins qui ne sont pas inscrits dans le bac à sable peuvent être stockés dans la base de données de Dynamics 365 Server ou dans le système de fichiers sur disque. Nous vous recommandons vivement de stocker vos plug-ins prêts pour la production dans la base de données Dynamics 365 Customer Engagement (on-premises), plutôt que sur disque. Les plug-ins stockés dans la base de données sont automatiquement distribués sur plusieurs serveurs Dynamics 365 dans un cluster de centre de données. Le stockage sur disque des plug-ins est utile pour le débogage des plug-ins à l’aide de Visual Studio. Toutefois, vous pouvez déboguer un plug-in stocké dans la base de données. Pour plus d’informations, consultez Déboguer un plug-in.

Les plug-ins inscrits dans le bac à sable doivent être stockés dans la base de données, quel que soit le déploiement de Dynamics 365 Customer Engagement (sur site, IFD ou en ligne).

Déploiement

Pour les installations Dynamics 365 Customer Engagement sur site ou exposées à Internet (IFD), lorsque vous déployez des plug-ins à partir d’un autre ordinateur sur le disque du serveur Dynamics 365 (déploiement sur disque), l’assembly de plug-in doit être copié manuellement sur le serveur avant l’enregistrement. L’assembly doit être déployé dans le <installdir>dossier \Program Files\Microsoft CRM\server\bin\assembly sur chaque serveur sur lequel le plug-in doit s’exécuter.

L’inscription du plug-in doit être effectuée une fois que l’assembly a été copié dans le dossier ...\bin\assembly sur le serveur afin d’éviter qu’un utilisateur du système ne déclenche un événement dans Dynamics 365 Customer Engagement (on-premises) mais que l’assembly de plug-in enregistré n’existe pas encore sur le serveur. Pour le déploiement d’une base de données serveur, l’assembly du plug-in est automatiquement copié lors de l’enregistrement du plug-in, de sorte que la situation antérieure ne pose pas de problème.

Selon la conception de votre plug-in, il se peut que celui-ci nécessite l'exécution d'autres assemblies référencées. Que vous déployiez votre plug-in sur la base de données ou sur le disque, si votre plug-in nécessite l’exécution d’autres assemblys, vous devez placer des copies de ces assemblys dans le cache d’assembly global sur chaque serveur sur lequel le plug-in doit s’exécuter.

Pour déplacer un plug-in d’un environnement de développement vers un serveur intermédiaire ou de production

1. Sur l’ordinateur de développement, générez le code du plug-in. N’ajoutez pas d’informations de débogage. Optimisez les performances du plug-in.
2. Enregistrez le plug-in dans la base de données Dynamics 365 Server.
3. À l’aide de l’application Web Dynamics 365 Customer Engagement (on-premises), créez une solution ou utilisez une solution existante, puis ajoutez le plug-in à cette solution.
4. Une fois que vous avez ajouté d’autres composants souhaités à la solution, exportez la solution.
5. Importez la solution sur le serveur intermédiaire ou le serveur de production.

Restrictions de sécurité

Il existe une restriction de sécurité qui permet uniquement aux utilisateurs privilégiés d’enregistrer des plug-ins. Pour les plug-ins qui ne sont pas inscrits dans le sandbox (isolation), le compte d’utilisateur système sous lequel le plug-in est enregistré doit exister dans le groupe Administrateurs de déploiement du Gestionnaire de déploiement. Seul le compte d’utilisateur Administrateur système ou tout compte d’utilisateur inclus dans le groupe Administrateurs de déploiement peut exécuter le Gestionnaire de déploiement.

Pour les plug-ins inscrits dans le bac à sable (mode d’isolation), le compte d’utilisateur système sous lequel le plug-in est enregistré doit avoir le rôle Administrateur système. L’appartenance au groupe Administrateurs de déploiement n’est pas requise.

Voir aussi

Développement de plug-ins
Déboguer un plug-in
Empaqueter et distribuer des extensions avec les solutions Dynamics 365 Customer Engagement (on-premises)