Procédure pas-à-pas : inscrire un plug-in à l’aide de l’outil Plug-in Registration (Inscription de plug-in)

 

Date de publication : janvier 2017

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

Cette procédure pas-à-pas montre comment inscrire un plug-in à l’aide de l’outil Plug-in Registration qui est fourni dans le Kit de développement logiciel. Le plug-in inscrire est le FollowupPlugin de la rubrique Exemple : Créer un plug-in de base.

Le plug-in doit être inscrit sur l’entité account, le message CreateRequest, sur un post-événementiel et dans le bac à sable. Le plug-in peut être inscrit sur tout déploiement Microsoft Dynamics 365 (Online et local) où votre compte utilisateur possède le rôle Personnalisateur système ou Administrateur système.

La configuration requise suivante doit être effectuée avant de commencer cette procédure pas-à-pas :

• Procurez-vous l’outil PluginRegistration.exe situé dans le dossier Tools\PluginRegistration du Kit de développement logiciel.Téléchargez le package Kit de développement logiciel (SDK) de Microsoft Dynamics CRM.

• Obtenez un compte utilisateur système sur un serveur Microsoft Dynamics 365.

• Votre compte utilisateur doit disposer du rôle Personnalisateur de système ou Administrateur système. Pour plus d'informations, consultez Comment la sécurité hiérarchique permet de contrôler l'accès aux entités dans Microsoft Dynamics 365.

Se connecter au serveur Microsoft Dynamics 365

1. Exécutez l'outil Plug-in Registration.

2. Cliquez sur CRÉER UNE NOUVELLE CONNEXION.

3. Dans la boîte de dialogue Connexion, activez la case d’option du type de déploiement correspondant au serveur Microsoft Dynamics 365 auquel vous envisagez d’inscrire les plug-ins. La case d’option Local comprend un déploiement IFD, le bouton En ligne est destiné au fournisseur Windows Live de Microsoft Dynamics 365 (Online), et le bouton Office 365 est destiné au fournisseur Microsoft Online Services de Microsoft Dynamics 365 (Online).

   Fenêtre de connexion pour un déploiement en ligne

   Fenêtre de connexion pour un déploiement local

4. Si vous cochez Toujours afficher la liste des organisations disponibles, la liste des organisations auxquelles vous appartenez s'affiche après avoir cliqué sur Connexion. Cela vous permet de choisir l’organisation pour laquelle vous souhaitez inscrire le plug-in. Sinon, votre organisation par défaut est utilisée.

5. Entrez les informations affichées sur le compte de serveur et d'ouverture de session, puis cliquez sur Connexion.

Vous devriez voir une liste réduite d’assemblys de plug-in ou d’activité de workflow personnalisée et de points de terminaison inscrits. Les flux d’activités et les assemblys Microsoft.Crm.ObjectModel sont requis pour Microsoft Dynamics 365 afin de fonctionner correctement et que l’outil vous empêche de les modifier. La sélection d’un élément de la liste entraîne l’affichage d’informations sur cet élément de liste dans les volets des onglets Propriétés et Détails.

Fenêtre principale de l’application

Inscrire un assembly de plug-in

1. Sélectionnez un onglet d’organisation pour le rendre actif.

2. Dans la barre d'outils de l'onglet, cliquez sur Inscrire, puis Inscrire un nouvel assembly.

3. Dans la boîte de dialogue Inscrire un nouvel assembly, cliquez sur les points de suspension […] à droite du champ Étape 1.

4. Dans la boîte de dialogue Ouvrir, accédez à l’emplacement de l’assembly SamplePlugin.dll compilé. L’emplacement par défaut est SDK\SampleCode\CS\Plug-ins\bin\Debug. Sélectionnez l’assembly, puis cliquez sur Ouvrir.

5. Dans la section Étape 2, développez l’assembly SamplePlugins pour afficher tous les plug-ins de cet assembly. Sélectionnez (cochez) uniquement le plug-in Microsoft.Crm.Sdk.Samples.FollowupPlugin.

6. Dans la section Étape 3, sélectionnez l’option Bac à sable (sandbox).

7. Dans la section Étape 4, sélectionnez l’option Base de données.

   

   Boîte de dialogue permettant d’inscrire un assembly

8. Cliquez sur Inscrire les plug-ins sélectionnés. Vous pouvez fermer les boîtes de dialogue ouvertes.

   

   Plug-in inscrit figurant dans l’arborescence

   Conseil

   Voyez-vous une erreur dans la zone Journal et le journal contient-il le message suivant ?

   <Message>Action failed for assembly 'SamplePlugins, Version=0.0.0.0, Culture=neutral, PublicKeyToken=829f574d80e89132': Deployment/Scalegroup does not allow running external code.</Message>

   Si oui, vous devez activer le code personnalisé sur le serveur et réessayer. Pour plus d'informations, voir Activer ou désactiver l’exécution de code personnalisé.

L’assembly SamplePlugins.dll et le plug-in FollowupPlugin sont désormais inscrits et déployés sur le serveur. Si vous utilisez l’outil pour inscrire un assembly d’activité de workflow personnalisée, la section suivante de l’inscription d’une étape ne s’appliquera pas.

Inscrire une étape du plug-in pour un événement

1. Dans l’arborescence Plug-ins inscrits et activités de workflow personnalisées, développez le nœud (Assembly) SamplePlugins et sélectionnez un plug-in inscrit.

2. Accédez au menu Inscrire dans la barre d’outils, puis cliquez sur Inscrire une nouvelle étape.

   Notes

   Les plug-ins sont inscrits pour s’exécuter lorsqu’un événement est traité dans le pipeline d’exécution des événements. Chaque événement a son nom et numéro de phase pour désigner son emplacement dans le pipeline soit avant ou après l’opération de plateforme principale. Une étape fait référence à l’entité de l’étape de traitement du message SDK qui sert à configurer quand et comment un plug-in doit être exécuté.

3. Remplissez la boîte de dialogue Inscrire une nouvelle étape comme illustré dans la figure suivante.

   

   Boîte de dialogue permettant d’inscrire une nouvelle étape

4. Cliquez sur Inscrire une nouvelle étape.

5. Développez le nœud (Assembly) SamplePlugins et les sous-nœuds pour afficher le plug-in et les nœuds d’étape que vous avez créés. Vous pouvez maintenant fermer l’outil, ou le laisser ouvert jusqu’à ce que vous ayez terminé de tester le plug-in et d’annuler l’inscription de l’assembly.

   Notes

   Pour annuler l’inscription de l’étape, du plug-in ou de l’assembly, sélectionnez son nœud dans l’arborescence, puis cliquez sur Annuler l’inscription dans la barre d’outils. Pour modifier un assembly ou une inscription d’étape, double-cliquez sur l’assembly ou le nœud d’étape dans l’arborescence. Sinon, vous pouvez sélectionner le nœud, puis cliquez sur Mettre à jour dans la barre d’outils.

Le plug-in est désormais inscrit pour s’exécuter dans le bac à sable, pour un événement de création de compte, après l’exécution de l’opération principale. Vous avez inscrit le plug-in pour une exécution asynchrone puisque la création de l’activité de tâche de suivi n’est pas urgente. Une fois le compte créé, le plug-in s’exécute la prochaine fois que le service asynchrone traitera sa file d’attente.

Test du plug-in

Après avoir inscrit le plug-in, vous pouvez éventuellement tester son exécution en utilisant la procédure suivante.

1. Ouvrez l’application Web Microsoft Dynamics 365 pour la même organisation sous laquelle vous avez inscrit l’assembly de plug-in.

2. Accédez à l’espace de travail, sélectionnez Comptes, puis cliquez sur Nouveau.

3. Dans la zone Nom du compte, tapez un nom de compte, par exemple, Adventure Works Cycle, puis cliquez sur Enregistrer et fermer.

4. Double-cliquez sur le nom du formulaire dans la grille Comptes pour ouvrir le formulaire.

5. Cliquez sur Activités pour afficher la liste des activités associées du compte. Vous devriez voir l’activité nommée “Send email to the new customer“ que le plug-in a créée.

6. Si vous avez inscrit le plug-in pour qu’il s’exécute de manière asynchrone sans sélectionner l’option Supprimer AsyncOperation si StatusCode = réussi sur le formulaire Inscrire une nouvelle étape, il y aura une tâche système nommée “FollowupPlugin: Create of account”. Pour afficher la tâche système associée, cliquez sur Paramètres, puis sur Tâches système. Double-cliquez sur la tâche système précédemment mentionnée.

Vous pouvez désormais annuler l’inscription de l’étape, le plug-in et l’assembly, si vous le souhaitez. Vous pouvez également supprimer la tâche système et le compte créés.

Voir aussi

Développement de plug-ins
Procédure pas-à-pas : configurer la sécurité d’assembly pour un plug-in hors connexion
Inscrire et déployer des plug-ins
Pipeline d’exécution des événements
Isolement, approbations et statistiques des plug-ins
Messages et entités pris en charge pour les plug-ins

Microsoft Dynamics 365

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