Show Menu
SUJETS×

Configuration du service OData de Microsoft Dynamics

Microsoft Dynamics est un logiciel de gestion de la relation client (CRM, Customer Relationship Management) et de planification des ressources de l’entreprise (ERP, Enterprise Resource Planning) 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’intégration de données d’AEM Forms fournit une configuration de service cloud OData pour intégrer Forms aux serveurs Microsoft Dynamics en ligne et sur site. Elle vous permet de créer un modèle de données de formulaire basé sur des entités, des attributs et des services définis dans le service Microsoft Dynamics. Le modèle de données de formulaire peut être utilisé pour créer des formulaires adaptatifs qui interagissent avec le serveur Microsoft Dynamics pour activer les workflows d'entreprise. Par exemple :
  • Requête du serveur Microsoft Dynamics pour les données et préremplir les formulaires adaptatifs
  • Écrire des données dans Microsoft Dynamics lors de l'envoi du formulaire adaptatif
  • Ecrire 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 et vice versa
Le module complémentaire AEM Forms inclut également la configuration OData de référence que vous pouvez exploiter pour intégrer rapidement Microsoft Dynamics aux AEM Forms.
Lorsque le package est installé, les entités et services suivants sont déployés sur votre instance AEM Forms :
  • Service cloud OData MS Dynamics (service OData)
  • Modèle de données de formulaire avec entités et services Microsoft Dynamics préconfigurés.
The OData Cloud Service and form data model with preconfigured Microsoft Dynamics entities and services are available on your AEM Forms instance only if the run mode for the AEM instance is set as samplecontent (default). Pour plus d’informations sur la configuration des modes d’exécution pour une instance AEM, voir Modes d’exécution .

Conditions préalables

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

Procédez comme suit pour définir l’URL de réponse de l’application Microsoft Dynamics enregistrée :
Utilisez cette procédure uniquement lors de l’intégration d’AEM Forms au serveur Microsoft Dynamics en ligne.
  1. Go to Microsoft Azure Active Directory account and add the following cloud service configuration URL in Reply URLs settings for your registered application:
    https://'[server]:[port]'/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
  2. Enregistrez la configuration.

Configuration de Microsoft Dynamics pour IFD

Microsoft Dynamics utilise l’authentification basée sur les réclamations pour fournir l’accès aux données sur le serveur Microsoft Dynamics CRM aux utilisateurs externes. Pour ce faire, procédez comme suit pour configurer Microsoft Dynamics pour le déploiement par Internet (IFD) et configurer les paramètres de réclamation.
Utilisez cette procédure uniquement lors de l’intégration d’AEM Forms au serveur Microsoft Dynamics sur site.
  1. Configure Microsoft Dynamics on-premises instance for IFD as described in Configure IFD for Microsoft Dynamics .
  2. Exécutez les commandes suivantes à l’aide de Windows PowerShell pour configurer les paramètres de réclamation sur Microsoft Dynamics compatible avec IFD :
    Add-PSSnapin Microsoft.Crm.PowerShell
     $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings
     $ClaimsSettings.Enabled = $true
     Set-CrmSetting -Setting $ClaimsSettings
    
    

Configuration du client OAuth sur une machine AD FS

Procédez comme suit pour enregistrer un client OAuth sur la machine Active Directory Federation Services (AD FS) et octroyer l’accès sur la machine AD FS :
Utilisez cette procédure uniquement lors de l’intégration d’AEM Forms au serveur Microsoft Dynamics sur site.
  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 de n’importe quel générateur de GUID.
    • redirect-uri est l’URL du service cloud OData de Microsoft Dynamics dans AEM Forms. Le service cloud par défaut installé avec le package AEM 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 suivante pour octroyer l’accès sur la machine AD FS :
    Grant-AdfsApplicationPermission -ClientRoleIdentifier “<Client-ID>” -ServerRoleIdentifier <resource> -ScopeNames openid
    Où :
    • resource est l'URL de l'organisation Microsoft Dynamics.
  3. Microsoft Dynamics utilise le protocole HTTPS. Pour appeler les points de fin AD FS depuis le serveur Forms, installez le certificat de site Microsoft Dynamics dans le fichier de stockage des certificats Java à l’aide de la commande keytool sur l’ordinateur exécutant AEM Forms.

Configurer le service cloud pour votre service Microsoft Dynamics

The MS Dynamics OData Cloud Service (OData Service) configuration comes with default OData configuration. Pour le configurer afin qu’il se connecte à votre service Microsoft Dynamics, procédez comme suit.
  1. Accédez à Outils > Services cloud > Sources de données et appuyez sur le dossier de configuration global .
  2. Sélectionnez la configuration du service cloud OData MS Dynamics (service OData) et appuyez sur Propriétés . La boîte de dialogue Propriété de configuration du service cloud s’affiche.
    Dans l’onglet Paramètres d’authentification  :
    1. Saisissez la valeur pour le champ Racine du service . Go to the Dynamics instance and navigate to Developer Resources to view the value for the Service Root field. Par exemple, https://<nom-client>/api/data/v9.1/
    2. Remplacez les valeurs par défaut dans les champs ID client (également appelé ID d’application ), Secret client , URL OAuth , URL du jeton d’actualisation , URL du jeton d’accès et Ressource avec les valeurs de votre configuration de service Microsoft Dynamics. It is mandatory to specify the dynamics instance URL in the Resource field to configure Microsoft Dynamics with a form data model. Utilisez l’URL racine du service pour dériver l’URL de l’instance de dynamique. For example, https://org.crm.dynamics.com .
    3. Specify openid in the Authorization Scope field for authorization process on Microsoft Dynamics.
  3. Cliquez sur Connexion à OAuth . Vous êtes redirigé vers la page de connexion de Microsoft Dynamics.
  4. Connectez-vous à l'aide de vos informations d'identification Microsoft Dynamics et acceptez d'autoriser la configuration du service cloud à se connecter au service Microsoft Dynamics. C’est une tâche ponctuelle qui permet d’établir une connexion entre 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 été enregistrée avec succès.
Le service cloud OData MS Dynamics (Service OData) est configuré et connecté à votre service Dynamics.

Créer un modèle de données de formulaire

When you install the AEM Forms package, a form data model, Microsoft Dynamics FDM , is deployed on your AEM instance. Par défaut, le modèle de données de formulaire utilise le service Microsoft Dynamics configuré dans le Cloud Service MS Dynamics OData (OData Service) comme source de données.
Lorsque vous ouvrez le modèle de données de formulaire pour la première fois, il se connecte au service Microsoft Dynamics configuré et récupère les entités de votre instance Microsoft Dynamics. Les entités « Contact » et « Prospect » de Microsoft Dynamics sont déjà ajoutées au modèle de données de formulaire.
Pour vérifier le modèle de données de formulaire, accédez à Formulaires > Intégrations de données . Sélectionnez Microsoft Dynamics FDM et cliquez sur Modifier pour ouvrir le modèle de données de formulaire en mode édition. Vous pouvez également ouvrir le modèle de données de formulaire directement à partir de l’URL suivante :
https://'[server]:[port]'/aem/fdm/editor.html/content/dam/formsanddocuments-fdm/ms-dynamics-fdm
Vous pouvez ensuite créer un formulaire adaptatif basé sur le modèle de données de formulaire 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 services Microsoft Dynamics
  • Appeler les opérations du serveur Microsoft Dynamics définies dans un modèle de données de formulaire à l'aide de règles de formulaire adaptatif
  • Écrire les données de formulaire envoyées dans les entités Microsoft Dynamics
Il est recommandé de créer une copie du modèle de données de formulaire fourni avec le package AEM Forms et de configurer les modèles de données et les services en fonction de vos besoins. Ainsi, les futures mises à jour du package de ne remplaceront pas votre modèle de données de formulaire.
Pour plus d’informations sur la création et l’utilisation de modèles de données de formulaire dans les processus métier, voir Intégration de données .