Inscrire un plug-in pour être déployé localement

  • Article

Les plug-ins et les activités de workflow personnalisées représentent du code personnalisé que vous développez pour étendre les fonctionnalités existantes de Dynamics 365 Customer Engagement (on-premises). Avant de pouvoir utiliser un plug-in ou une activité de workflow personnalisée, une inscription serveur est nécessaire. Un outil d’enregistrement de plug-in et d’activité de workflow personnalisée est disponible en téléchargement.

Les informations générales sur l’inscription du plug-in et de l’assembly de workflow personnalisé se trouvent dans les rubriques de Dataverse Inscrire un plug-in et Inscrire votre assembly. Les informations suivantes ci-dessous sont spécifiques au développement de plug-in local.

Même si cette rubrique se concentre principalement sur les plug-ins, la plupart des informations s’appliquent également aux activités de workflow personnalisées. La seule différence entre les deux est que pour les assemblys d’activité de workflow personnalisée, vous n’inscrivez que l’assembly. Pour les plug-ins, inscrivez l’assembly de plug-in et une ou plusieurs étapes par plug-in. Pour plus d’informations sur les activités de workflow personnalisées, voir Activités de workflow personnalisées (assemblys de workflow).

Important

N’inscrivez aucun plug-in ni aucune activité de workflow personnalisée sauf en cas d’obtention d’une une source fiable et approuvée.

Enregistrement des plug-ins

 

Pour un déploiement local, les plug-ins qui ne sont pas inscrits dans le bac à sable (sandbox) peuvent être enregistrés dans la base de données du serveur Dynamics 365 Server ou dans le système de fichiers sur disque. Nous vous recommandons vivement d’enregistrer vos plug-ins prêts pour la production dans la base de données Dynamics 365 Customer Engagement (on-premises), au lieu de le faire sur le disque. Les plug-ins enregistrés dans la base de données sont automatiquement distribués sur plusieurs serveurs des serveurs Dynamics 365 Server dans un cluster de centre de données. Le stockage sur disque des plug-ins est utile pour déboguer les plug-ins avec Visual Studio. Cependant, vous pouvez déboguer un plug-in qui est stocké dans la base de données. Pour plus d’informations, voir Déboguer un plug-in.

Les plug-ins inscrits dans le bac à sable doivent être stockés dans la base de données indépendamment du déploiement de Dynamics 365 Customer Engagement (on-premises) (en local, IFD, ou en ligne).

Déploiement

 

Pour les installations Dynamics 365 Customer Engagement (on-premises) locales avec accès via internet, lorsque vous déployez des plug-ins à partir d’un ordinateur sur le disque Dynamics 365 Server (déploiement sur disque), l’assembly de plug-in doit être copié manuellement sur le serveur avant l’inscription. L’assembly doit être déployé dans le dossier <installdir>\Program Files\Microsoft CRM\Server\bin\assembly sur chaque serveur sur lequel le plug-in doit s’exécuter.

L’inscription des plug-ins doit être effectuée après la copie de l’assembly dans le dossier …\bin\assembly sur le serveur pour empêcher le cas où un utilisateur système déclenche un événement dans Dynamics 365 Customer Engagement (on-premises), mais l’assembly de plug-in inscrit n’existe pas encore sur le serveur. Pour le déploiement de base de données serveur, l’assembly du plug-in est copié automatiquement lors de l’inscription des plug-ins pour que la situation antérieure ne constitue pas un problème.

En fonction de la conception de votre plug-in, vos plug-ins peuvent nécessiter d’autres assemblys référencés pour s’exécuter. Que vous déployez votre plug-in dans la base de données ou sur le disque, si votre plug-in nécessite d’autres assemblys pour s’exécuter, vous devrez placer les copies de ces assemblys dans le cache d’assembly global sur chaque serveur où le plug-in doit être exécuté.

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, définissez le code du plug-in. N’ajoutez pas d’informations de débogage. Optimisez le plug-in pour obtenir de meilleures performances.
  2. Inscrivez 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-en une existante et ajoutez le plug-in à cette solution.
  4. Après avoir ajouté tous les autres composants souhaités à la solution, exportez la solution.
  5. Importez la solution vers le serveur intermédiaire ou de production.

Restrictions de sécurité

Il existe une restriction de sécurité qui permet aux utilisateurs privilégiés uniquement d’inscrire les plug-ins. Pour les plug-ins qui ne sont pas inscrits dans un contexte de bac à sable (isolé), le compte d’utilisateur système sous lequel est inscrit le plug-in doit exister dans le groupe Administrateurs de déploiement du Gestionnaire de déploiement. Seul le compte Administrateur système ou n’importe quel autre compte d’utilisateur inclus dans le groupe Administrateurs de déploiement peut exécuter le Gestionnaire de déploiement.

Important

Pour les plug-ins non isolés, le fait d’omettre d’inclure le compte d’inscription dans le groupe Administrateurs de déploiement entraîne une exception levée au cours de l’inscription des plug-ins. La description de l’exception indique que les privilèges permettant d’exécuter l’opération de création pour une entité SDK sont insuffisants.

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

Voir aussi

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