Configuration de Microsoft Dynamics OData microsoft-dynamics-odata-configuration

Version
Lien de l’article
AEM 6.5
Cliquez ici
AEM as a Cloud Service
Cet article

data-integeration

Microsoft Dynamics est un logiciel de gestion de la relation client (Customer Relationship Management, CRM) et de planification des ressources de l’entreprise (Enterprise Resource Planning, ERP), qui fournit des solutions d’entreprise pour la création et la gestion de comptes clients, de contacts, de prospects, d’opportunités et de dossiers. L’Experience Manager Forms intégration de données fournit une configuration de service cloud OData permettant d’intégrer Forms aux serveurs Microsoft Dynamics On-premise et en ligne. Il vous permet de créer un modèle de données de formulaire (FDM) basé sur les entités, les attributs et les services définis dans le service Microsoft Dynamics. Le modèle de données de formulaire (FDM) peut être utilisé pour créer un Forms adaptatif qui interagit avec le serveur Microsoft Dynamics pour activer les processus d’entreprise. Par exemple :

  • Demander des données à un serveur Microsoft Dynamics et préremplir des formulaires adaptatifs
  • Écrire des données dans Microsoft Dynamics sur un envoi de formulaires adaptatifs
  • Écrire des données dans Microsoft Dynamics par le biais d’entités personnalisées définies dans le modèle de données de formulaire (FDM) et inversement

Le Cloud Service OData MS Dynamics (service OData) est disponible avec tous les modes d’exécution. Pour plus d’informations sur la configuration des modes d’exécution pour une instance Experience Manager, voir Modes d’exécution.

AEM as a Cloud Service propose différentes actions d’envoi prêtes à l’emploi pour gérer les envois de formulaire. Vous pouvez en savoir plus sur ces options dans l’article Action d’envoi de formulaire adaptatif .

Conditions préalables prerequisites

Avant de commencer à installer et à configurer Microsoft Dynamics, vérifiez que vous avez :

Définition de l’URL de réponse pour l’application Microsoft Dynamics enregistrée set-reply-url-for-registered-microsoft-dynamics-application

Pour définir l’URL de réponse de l’application Microsoft Dynamics enregistrée :

NOTE
N’utilisez cette procédure que lors de l’intégration d’Experience Manager Formsau serveur Microsoft Dynamics en ligne.
  1. Accédez au compte Active Directory Microsoft Azure et ajoutez l’URL de configuration du service cloud suivante dans les paramètres des URL de réponse pour votre application enregistrée :

    https://[server]:[port]/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

    Azure Directory

  2. Enregistrez la configuration.

Configuration de Microsoft Dynamics pour IFD configure-microsoft-dynamics-for-ifd

Microsoft Dynamics utilise l’authentification basée sur les réclamations pour permettre aux utilisateurs externes d’accéder aux données sur le serveur CRM Microsoft Dynamics. À cet effet, procédez comme suit pour configurer Microsoft Dynamics pour le déploiement par Internet (IFD) et configurer les paramètres de réclamation.

NOTE
N’utilisez cette procédure que lors de l’intégration d’Experience Manager Forms au serveur Microsoft Dynamics local.
  1. Configurez l’instance locale d’Microsoft Dynamics pour IFD, comme décrit dans Configurer IFD pour Microsoft Dynamics.

  2. Exécutez les commandes ci-dessous à l’aide de Windows PowerShell pour configurer les paramètres de réclamation sur Microsoft Dynamics compatible avec IFD :

    code language-shell
    Add-PSSnapin Microsoft.Crm.PowerShell
     $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings
     $ClaimsSettings.Enabled = $true
     Set-CrmSetting -Setting $ClaimsSettings
    

    Pour plus d’informations, voir Enregistrement de l’application pour CRM local (IFD).

Configuration du client OAuth sur une machine AD FS configure-oauth-client-on-ad-fs-machine

Pour enregistrer un client OAuth sur l’ordinateur Active Directory Federation Services (AD FS) et octroyer l’accès sur l’ordinateur AD FS :

NOTE
N’utilisez cette procédure que lors de l’intégration d’Experience Manager Forms au serveur Microsoft Dynamics local.
  1. Exécutez la commande suivante :

    Add-AdfsClient -ClientId “<Client-ID>” -Name "<name>" -RedirectUri "<redirect-uri>" -GenerateClientSecret

    Où :

    • Client-ID est un ID client que vous pouvez générer à l’aide d’un générateur de GUID.

    • redirect-uri est l’URL du service cloud OData de Microsoft Dynamics dans Experience Manager Forms. Le service cloud par défaut installé avec Experience Manager Forms est déployé à l’adresse URL suivante :

      https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html

  2. Exécutez la commande ci-dessous pour octroyer l’accès sur l’ordinateur AD FS :

    Grant-AdfsApplicationPermission -ClientRoleIdentifier “<Client-ID>” -ServerRoleIdentifier <resource> -ScopeNames openid

    Où :

    • resource est l’URL de l’organisation de Microsoft Dynamics.
  3. Microsoft Dynamics utilise le protocole HTTPS. Pour appeler les points d’entrée AD FS à partir du serveur Forms, installez le certificat de site Microsoft Dynamics dans le magasin de certificats Java à l’aide de la commande keytool sur l’ordinateur exécutant Experience Manager Forms.

Configuration du service cloud pour votre service Microsoft Dynamics configure-cloud-service-for-your-microsoft-dynamics-service

Un service OData est identifié par son URL racine de service. Pour configurer un service OData dans Experience Manager as a Cloud Service, vérifiez que vous disposez de l’URL racine du service et procédez comme suit :

NOTE
Pour obtenir un guide pas à pas sur la configuration de Microsoft Dynamics 365, en ligne ou sur site, voir Microsoft Dynamics Configuration OData.
  1. Accédez à Outils > Services Cloud > Sources de données. Sélectionnez le dossier dans lequel vous souhaitez créer une configuration cloud.

    Pour plus d’informations sur la création et la configuration d’un dossier pour les configurations de service cloud, voir Configurer le dossier pour les configurations de service cloud.

  2. Sélectionnez Créer pour ouvrir l’assistant Créer une configuration de source de données. Indiquez un nom et éventuellement un titre pour la configuration, sélectionnez Service OData dans la liste déroulante Type de service, recherchez et sélectionnez éventuellement une image miniature pour la configuration, puis sélectionnez Suivant.
    Dans l’onglet Paramètres d’authentification :

    1. Saisissez la valeur du champ Racine du service. Accédez à l’instance Dynamics et à Ressources de développement pour afficher la valeur du champ Racine du service. Par exemple, https://<nom-client>/api/data/v9.1/

    2. Sélectionnez OAuth 2.0 comme type d’authentification.

    3. Remplacez les valeurs par défaut dans les champs ID client (également appelé ID d’application), Secret du client, URL OAuth, URL du jeton d’actualisation, URL du jeton d’accès et Ressource par les valeurs de votre configuration de service Microsoft Dynamics. Il est obligatoire de spécifier l’URL de l’instance de dynamique dans le champ Resource pour configurer Microsoft Dynamics avec un modèle de données de formulaire (FDM). Utilisez l’URL racine du service pour dériver l’URL de l’instance dynamique. For example, https://org.crm.dynamics.com.

    4. Spécifiez openid dans le champ Champ d’application de l’autorisation pour la procédure d’autorisation sur Microsoft Dynamics.

      Paramètres d’authentification
      Modèle de données de formulaire (FDM)

  3. Cliquez sur Se connecter à OAuth. Vous êtes redirigé vers la page de connexion de Microsoft Dynamics.

  4. Connectez-vous avec vos informations d’identification Microsoft Dynamics et autorisez la connexion de la configuration du service cloud au service Microsoft Dynamics. Il s’agit d’une tâche unique permettant de définir le modèle de données de formulaire (FDM) pour le service cloud et le service.

    Vous êtes ensuite redirigé vers la page de configuration du service cloud, qui affiche un message indiquant que la configuration OData a bien été enregistrée.

Le service cloud MS Dynamics OData Cloud Service (Service OData) est configuré et connecté à votre service Dynamics. Modèle de données de formulaire (FDM)

Créer un modèle de données de formulaire (FDM) create-form-data-model

Après avoir configuré le service cloud OData de MS Dynamics, vous pouvez utiliser le service lors de la création d’un modèle de données de formulaire (FDM). Pour plus d’informations, voir Création d’un modèle de données de formulaire (FDM).

Ensuite, vous pouvez créer un modèle de données de formulaire adaptatif (FDM) et l’utiliser dans divers cas d’utilisation de formulaire adaptatif, tels que :

  • Remplir le formulaire adaptatif en obtenant des informations des entités et des services Microsoft Dynamics
  • Appeler Microsoft Dynamics opérations de serveur définies dans un modèle de données de formulaire (FDM) à l’aide de règles de formulaire adaptatif
  • Écrire les données de formulaire envoyées dans les entités Microsoft Dynamics

Vous pouvez configurer l’action d’envoi de modèle de données de formulaire pour un formulaire adaptatif afin d’envoyer des données à Microsoft Dynamics OData.

Pour plus d’informations sur la création et l’utilisation du modèle de données de formulaire (FDM) dans les processus d’entreprise, voir Intégration de données.

Articles connexes

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab