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

  • Article

 

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Ce guide pas-à-pas montre comment configurer Service Microsoft Azure Active Directory Access Control Service (ACS) et inscrire une étape du point de terminaison de service au moyen de l'outil Plug-in Registration (Inscription de plug-in). Une fois configurés, Microsoft Dynamics CRM 2015 et Microsoft Dynamics CRM 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 :

Étapes

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

  1. Se connecter au serveur Microsoft Dynamics CRM

  2. Créer une configuration du point de terminaison de service

  3. Configurer ACS

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

  5. Tester l'inscription du point de terminaison

Se connecter au serveur Microsoft Dynamics CRM

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).

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

  2. Sélectionnez 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 un point de terminaison de service. La case d'option Local comprend un déploiement IFD, le bouton En ligne est destiné au fournisseur Windows Live de Microsoft Dynamics CRM Online, et le bouton Office 365 est destiné au fournisseur Microsoft Online Services de Microsoft Dynamics CRM Online.

    Formulaire de connexion pour un déploiement en ligne

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

    Formulaire 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 sélectionné 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.

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

Créer une configuration du point de terminaison de service

Suivez les étapes ci-dessous pour inscrire un point de terminaison de service Microsoft Azure.

  1. Sélectionnez l'onglet de l'organisation pour laquelle vous souhaitez inscrire un point de terminaison de service.

  2. Dans la barre d'outils de l'onglet, sélectionnez Inscrire, puis Inscrire un nouveau point de terminaison de service.

  3. Remplissez la boîte de dialogue Inscription du point de terminaison de service avec les informations relatives à votre solution, comme l'illustre la figure suivante et le décrit le tableau ci-dessous. Vérifiez que le contrat que vous spécifiez correspond au même contrat utilisé par l'application d'écoute de votre solution.

    Création d'un point de terminaison de service

    Elément d'interface utilisateur

    description

    Nom (champ)

    Nom de votre inscription du point de terminaison de service.

    Description (champ)

    Description de l'inscription à ce point de terminaison.

    Espace de noms de la solution (champ)

    Nom de l'espace de noms du service de la solution.

    Chemin d'accès (champ)

    Chemin de votre projet. Par exemple, pour une URL de point de terminaison de service de https://crmsdkdemo-sb.accesscontrol.windows.net/TwoWayService/Demo, le chemin est TwoWayService/Demo.

    Contrat (liste déroulante)

    Contrat de point de terminaison. Une application d'écoute doit utiliser ce contrat pour lire le message publié. Pour plus d'informations, voir Écrire un écouteur pour une solution Microsoft Azure.

    Revendication (liste déroulante)

    Revendications à envoyer à Microsoft Azure. Utilisez Aucune pour la revendication standard. Spécifiez UserId ou UserInfo pour envoyer des informations supplémentaires sur l'utilisateur connecté.

    Mode fédéré (case à cocher)

    Activez cette case pour utiliser le mode fédéré.

    ID (champ)

    Champ non-accessible en écriture qui se remplit automatiquement avec l'ID de la configuration du point de terminaison.

    Enregistrer et configurer ACS (bouton)

    Enregistre la configuration que vous avez entrée et automatise le processus de configuration de ACS. Fournit un mode interactif pour accomplir les tâches décrites dans la rubrique Guide pas à pas : Configurer Microsoft Azure ACS pour l’intégration avec Microsoft Dynamics CRM 2015.

    Enregistrer et vérifier l'authentification (bouton)

    Enregistre la configuration que vous avez entrée et vérifie que ACS est configuré correctement.

    Enregistrer (bouton)

    Enregistre la configuration que vous avez entrée et ferme la boîte de dialogue.

  4. Si vous n'avez pas encore configuré l'intégration de ACS avec Microsoft Dynamics 365, et que vous souhaitez que l'outil Plug-in Registration (Inscription de plug-in) effectue la configuration pour vous, sélectionnez Enregistrer et configurer ACS, puis suivez les instructions dans la section suivante de ce guide pas-à-pas. Si vous avez déjà configuré ACS, sélectionnez Enregistrer et vérifier l'authentification ou Enregistrer et continuez à suivre les instructions fournies dans Inscrire une étape du point de terminaison de service pour un événement.

Configurer ACS

Suivez les étapes ci-dessous pour configurer Service Microsoft Azure Active Directory Access Control Service (ACS).

  1. Après avoir sélectionné Enregistrer et configurer ACS, la boîte de dialogue Configuration d'ACS s'affiche. Entrez les valeurs de données appropriées dans les champs du formulaire comme indiqué dans le tableau suivant.

    Nom du champ

    Description

    Clé de gestion

    Clé de gestion de votre solution. Vous pouvez vous procurer la valeur de cette clé sur le Portail de gestion Azure.

    Obtenir une clé de gestion pour un espace de noms Bus des services

    1. Connectez-vous au portail Azure.

    2. Dans le volet gauche, sélectionnez Bus des services, puis sélectionnez l'espace de noms cible dans la liste.

    3. En bas de la page, sélectionnez Informations de connexion.

    4. Dans la boîte de dialogue Accès aux informations de connexion, la clé par défaut est affichée. Il s'agit de la clé de gestion.

    Notes

    Si vous avez modifié la clé symétrique, tapez cette clé au lieu de la clé par défaut dans le champ Clé de gestion. Si vous n'effectuez pas cette opération, vous pouvez recevoir des erreurs avec une description telle que : « ACS50012 : Échec d'authentification ».

    Fichier de certificat

    Fichier de certificat public ayant servi à configurer Microsoft Dynamics 365 pour une intégration avec Microsoft Azure.

    Pour Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015, vous pouvez télécharger ce fichier de certificat à partir du serveur. Dans l'application Web Microsoft Dynamics 365, sélectionnez Paramètres > Personnalisations, puis Ressources du développeur. Téléchargez et enregistrez le fichier du certificat à l'aide du lien fourni sous Certificat de l'émetteur du Microsoft Azure Service Bus Certificat de l'émetteur.

    Nom de l'émetteur

    Nom de l'émetteur. Ce nom doit être le même que celui qui a servi à configurer Microsoft Dynamics 365 pour l'intégration de Microsoft Azure. Vous pouvez obtenir le nom de l'émetteur à partir de la page web Ressources du développeur mentionnée dans la description précédente.

    Pour plus d'informations, voir Configuration de l'intégration d'Azure avec Microsoft Dynamics CRM 2015.

  2. Sélectionnez Configurer ACS. Un journal du processus de configuration s'affiche dans la zone de résultat du formulaire.

  3. Sélectionnez Fermer.

  4. Sélectionnez Enregistrer et vérifier l'authentification dans la boîte de dialogue Inscription du point de terminaison de service. Au terme de la vérification, vous pouvez fermer les boîtes de dialogue.

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.

  1. Sélectionnez le point de terminaison de service que vous avez précédemment enregistré dans l'arborescence de l'outil.

  2. Accédez au menu Inscrire, puis sélectionnez Inscrire une nouvelle étape.

  3. 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.

    Création d'une étape de point de terminaison de service

  4. Sélectionnez 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.

  1. Ouvrez l'application Web Microsoft Dynamics 365 pour la même organisation sous laquelle vous avez enregistré le point de terminaison de service.

  2. Sélectionnez le bouton CréerCréer un bouton, sélectionnez Compte.

  3. Entrez un nom de compte, par exemple Adventure Works Cycle, dans le champ Nom du compte, puis sélectionnez Enregistrer.

  4. Attendez 10 minutes environ pour que la publication du Microsoft Azure Service Bus ait lieu.

  5. Sélectionnez Paramètres > Tâches système.

  6. 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 CRM 2015
Intégration Azure avec Microsoft Dynamics CRM.
Active Directory et authentification basée sur les revendications

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