Procédure pas-à-pas : inscrire un plug-in compatible Azure avec l’outil Plug-in Registration

Article
03/04/2017

Date de publication : janvier 2017

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

Ce guide pas-à-pas montre comment inscrire une étape du point de terminaison de service au moyen de l'outil Plug-in Registration. Une fois configurés, Microsoft Dynamics 365 ou Microsoft Dynamics 365 (Online) peuvent publier le contexte d'exécution de l'opération en cours à un point de terminaison de solution Microsoft Azure. Pour ce guide pas-à-pas, l'étape est inscrite pour publier le contexte d'exécution du message CreateRequest pour une entité Account sur Microsoft Azure Service Bus.

La configuration requise suivante doit être effectuée avant de commencer ce guide pas-à-pas :

Accédez à l'outil Plug-in Registration. Vous trouverez le fichier exécutable de l'outil 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.
Votre compte utilisateur système Microsoft Dynamics 365 doit disposer du rôle Personnalisateur de système ou Administrateur système. Pour plus d'informations, voir Comment la sécurité hiérarchique permet de contrôler l'accès aux entités dans Microsoft Dynamics 365.
Avoir accès à un espace de noms de service de plateforme Microsoft Azure configuré pour l'autorisation ACS ou SAS, à laquelle Microsoft Dynamics 365 publiera un message.
Si vous utilisez Microsoft Dynamics 365, le serveur doit être configuré pour l'intégration de Microsoft Azure conformément aux instructions de la rubrique Configuration de l'intégration Azure avec Microsoft Dynamics 365.
Si vous comptez utiliser n'importe quelle entité de messagerie Azure autre qu'une file d'attente, par exemple un relais, il doit existe une application d'écouteur écoutant activement le point de terminaison de la solution spécifiée pour Microsoft Dynamics 365 pour publier avec succès sur Microsoft Azure Service Bus. Pour plus d'informations, voir Écrire une application d'écouteur pour une solution Microsoft Azure.
Un point de terminaison de service configuré avec l'autorisation ACS ou SAS est disponible dans l'organisation cible.Pour plus d'informations :Guide pas-à-pas : Configurer Microsoft Azure (ACS) pour l'intégration avec Dynamics 365, Guide pas-à-pas : Configurer Microsoft Azure (SAS) pour l'intégration avec Dynamics 365.

Étapes

Ce guide pas-à-pas contient les étapes suivantes :

Se connecter au serveur Microsoft Dynamics 365
Inscrire une étape du point de terminaison de service pour un événement
Tester l'inscription du point de terminaison

Se connecter au serveur Microsoft Dynamics 365

Suivez les étapes ci-dessous pour vous connecter au serveur Microsoft Dynamics 365 à l'aide de l'outil Plug-in Registration (Inscription de plug-in).

Exécutez l'outil Plug-in Registration.
Cliquez sur Créer une nouvelle connexion.
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 un point de terminaison de service. La case d'option Local comprend un déploiement IFD et le bouton Office 365 est pour le fournisseur Microsoft Online Services de Microsoft Dynamics 365 (Online).

Formulaire de connexion pour un déploiement en ligne

Formulaire de connexion pour un déploiement local
Si vous cochez 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 point de terminaison de service. Sinon, votre organisation par défaut est utilisée.
Entrez les informations affichées sur le compte de serveur et d'ouverture de session, puis cliquez sur Connexion.

Inscrire une étape du point de terminaison de service pour un événement

Suivez les étapes ci-dessous pour inscrire une étape pour un événement sur le point de terminaison de service.

Sélectionnez un point de terminaison de service existant dans l'onglet de l'onglet de l'organisation cible.
Accédez au menu Inscrire, puis cliquez sur Inscrire une nouvelle étape.
Complétez la boîte de dialogue Inscrire une nouvelle étape pour un compte permettant de créer un événement, comme illustré dans la figure suivante.
Cliquez sur Inscrire une nouvelle étape.

Microsoft Dynamics 365 publie maintenant le message actuel contenant le contexte d'exécution sur le bus des services lorsqu'un compte est créé. La publication est effectuée de manière asynchrone et ne s'exécute pas immédiatement.

Tester l'inscription du point de terminaison

Une fois le point de terminaison inscrit, vous pouvez le tester. Un écouteur doit s'exécuter ou une file d'attente doit être disponible sur le point de terminaison cible pour que la publication du bus des services par le plug-in se déclenche.

Ouvrez l'application Web Microsoft Dynamics 365 pour la même organisation sous laquelle vous avez enregistré le point de terminaison de service.
Cliquez sur le bouton Créer, cliquez sur Compte.
Entrez un nom de compte, par exemple Adventure Works Cycle, dans le champ Nom du compte, puis sélectionnez Enregistrer.
Attendez 10 minutes environ pour que la publication du Microsoft Azure Service Bus ait lieu.
Cliquez sur Paramètres > Tâches système.
Ouvrez la tâche système qui porte le même nom que celui que vous avez indiqué pour votre point de terminaison de service. Vérifiez le statut pour voir si la publication est réussie, en attente ou a échoué.

Vous pouvez désormais annuler l'inscription du point de terminaison, si nécessaire, en le sélectionnant dans l'arborescence de l'outil, puis Annuler l'inscription.

Voir aussi

Extensions Azure pour Microsoft Dynamics 365
Intégration Azure avec Microsoft Dynamics 365.

Microsoft Dynamics 365