DocumentationCampaignDocumentation de Campaign Classic v7

Connecter Campaign et Microsoft Dynamics 365 connect-to-msdyn

Last update: Thu Sep 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Dans cette page, vous apprendrez comment connecter Campaign Classic à Microsoft Dynamics CRM 365.

Un déploiement possible est effectué via l’API Web (recommandé). Pour découvrir comment configurer la connexion à Microsoft Dynamics, consultez la section ci-dessous.

La synchronisation des données s'effectue via une activité de workflow dédiée. En savoir plus.

Étapes dʼimplémentation microsoft-dynamics-implementation-steps

Pour connecter Microsoft Dynamics 365 à Adobe Campaign via Web API, vous devez appliquer les étapes suivantes :

Dans Microsoft Dynamics CRM :

  1. Obtention de l'identifiant du client Microsoft Dynamics
  2. Génération de l’identifiant de clé de certificat Microsoft Dynamics et de l’ID de clé
  3. Configuration des autorisations
  4. Création d'un utilisateur d'application
  5. Codage de la clé privée

En savoir plus dans cette section

Dans Campaign Classic :

  1. Création d'un nouveau compte externe
  2. Configuration du compte externe avec les paramètres Microsoft Dynamics
  3. Utilisation de l’assistant de configuration pour mapper des tableaux et synchroniser des énumérations
  4. Création du workflow de synchronisation

En savoir plus dans cette section

CAUTION
Lors de la connexion d'Adobe Campaign à Microsoft Dynamics, vous ne pouvez pas :
  • Installer de plug-in qui peut modifier le comportement du CRM, ce qui peut entraîner des problèmes de compatibilité avec Adobe Campaign
  • Sélectionner plusieurs énumérations

Configurer Microsoft Dynamics CRM config-crm-microsoft

Pour générer le jeton d'accès et les clés de configuration du compte, vous devez vous connecter à Microsoft Azure Directory à l'aide d'informations d’identification d'administrateur global. Suivez ensuite les étapes décrites ci-dessous.

Obtention de l'identifiant du client Microsoft Dynamics get-client-id-microsoft

Pour obtenir l'identifiant du client, vous devez enregistrer une application dans Azure Active Directory. L'identifiant du client est identique à l'ID de l'application.

  1. Accédez à Azure Active Directory > Enregistrements des applications, puis cliquez sur Nouvel enregistrement d'application.
  2. Donnez un nom unique qui peut aider à identifier une instance, par exemple adobecamcampaign<instance identifier>.
  3. Sélectionnez Type d'application comme application Web/API.
  4. Utilisez http://localhost comme URL de connexion.

Une fois que vous avez enregistré vos données, vous obtenez un ID de l'application qui est l'identifiant du client pour Campaign.

En savoir plus sur cette page.

Génération de l’identifiant de clé de certificat Microsoft Dynamics et de l’ID de clé config-certificate-key-id

Pour obtenir l’identifiant de clé de certificat (customKeyIdentifier) et l’identifiant de clé (keyId), procédez comme suit :

  1. Accédez à Azure Active Directory > Enregistrements des applications et sélectionnez l'application qui a été créée précédemment.

  2. Cliquez sur Certificats et secret.

  3. Cliquez sur Télécharger le certificat, puis recherchez et téléchargez le certificat public généré.

  4. Pour générer le certificat, vous pouvez utiliser openssl.

    Par exemple :

    code language-none 
    - openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
    note note
    NOTE
    Vous pouvez modifier le nombre de jours, ici -days 365, dans l’exemple de code pour une période de validité du certificat plus longue.

  5. Vous devrez ensuite le chiffrer en Base64. Pour cela, vous pouvez utiliser l'aide d'un encodeur Base64 ou utiliser la ligne de commande base64 -w0 private.key sous Linux.

  6. Cliquez sur le lien Manifest pour obtenir l'identifiant de clé de certificat (customKeyIdentifier) et l'ID de clé (keyId).

L’identifiant de clé de certificat (customKeyIdentifier) et l’identifiant de clé (keyId) seront nécessaires ultérieurement pour configurer votre compte externe Microsoft Dynamics CRM à l’aide du certificat type O-Auth CRM.

Configuration des autorisations config-permissions-microsoft

Étape 1  : configurez les autorisations obligatoires pour l'application qui a été créée.

  1. Accédez à Azure Active Directory > Enregistrements des applications et sélectionnez l'application qui a été créée précédemment.

  2. Cliquez sur Paramètres en haut à gauche.

  3. Sur Autorisations obligatoires, cliquez sur Ajouter et Sélectionner une API > Dynamics CRM Online.

  4. Cliquez sur Sélectionner, activez la case Accéder à Dynamics 365 en tant qu’utilisateurs de l’organisation et cliquez sur Sélectionner.

  5. Ensuite, dans l’application, sélectionnez le Manifest sous le menu Gérer.

  6. Dans l’éditeur Manifest, définissez la propriété allowPublicClient de null sur true et cliquez sur Enregistrer.

Étape 2  : autorisez le consentement administrateur

  1. Accédez à Répertoire actif Azure > Applications d’entreprise.

  2. Sélectionnez l’application à laquelle vous souhaitez accorder le consentement administrateur à l’échelle du client.

  3. Dans le menu du volet de gauche, sélectionnez Autorisations sous Sécurité.

  4. Cliquez sur Accorder le consentement administrateur.

Pour plus d'informations à ce propos, consultez la documentation Azure.

Création d'un utilisateur d'application create-app-user-microsoft

NOTE
Cette étape est facultative avec l’authentification Mots de passe.

L'utilisateur de l'application est l'utilisateur que l'application enregistrée ci-dessus utilisera. Toute modification apportée à Microsoft Dynamics à l'aide de l'application enregistrée ci-dessus sera effectuée via cet utilisateur.

Étape 1  : Création d'un utilisateur non interactif sur Azure Active Directory

  1. Cliquez sur Azure Active Directory > Utilisateurs et sur Nouvel utilisateur.
  2. Donnez un nom adapté que vous souhaitez utiliser et le nom d'utilisateur doit être au format d'un email.
  3. Sélectionnez Administrateur Dynamics 365 dans le Rôle de répertoire.

Étape 2  : Attribuer une licence appropriée à l'utilisateur créé

  1. Dans Microsoft Azure, cliquez sur Application d'administration.
  2. Accédez à Utilisateurs > Utilisateurs actifs et cliquez sur l'utilisateur qui vient d'être créé.
  3. Cliquez sur Modifier les licences de produit et sélectionnez Dynamics 365 Customer Engagement Plan.
  4. Cliquez sur Fermer.

Étape 3  : Création d'un utilisateur d'application sur Dynamics CRM

  1. Depuis Microsoft Azure, accédez à Paramètres > Sécurité > Utilisateurs.

  2. Cliquez dans la liste déroulante, sélectionnez Utilisateurs de l'application et cliquez sur Nouveau.

  3. Utilisez le même nom d'utilisateur que celui créé dans Active Directory ci-dessus

    note note
    NOTE
    L'utilisation du même nom génère une erreur de clé de duplicata. Aussi, tant que nous n'obtenons pas de confirmation indiquant que cette étape est nécessaire, utilisez un autre nom d'utilisateur et continuez.

  4. Affectez l'ID de l'application à l'application que vous avez créée précédemment.

  5. Cliquez sur Gérer les rôles et sélectionnez le rôle Administrateur système pour l'utilisateur.

Configuration de Campaign configure-acc-for-microsoft

NOTE
Publiez la mise hors service de RDS à partir de Microsoft. Les types de déploiements CRM On-premise et Office 365 ne sont plus compatibles avec Campaign. Adobe Campaign ne prend désormais en charge que le déploiement des API Web pour la version CRM Dynamic CRM 365. En savoir plus.

Pour connecter Microsoft Dynamics 365 et Campaign, vous devez créer et configurer un compte externe dédié dans Campaign.

  1. Accédez à Administration > Plateforme > Comptes externes.

  2. Sélectionnez le compte externe Microsoft Dynamics CRM. Cochez l'option Activé.

  3. Renseignez les informations requises pour connecter Microsoft Dynamics 365 et Campaign.

    note note
    NOTE
    La configuration du compte externe Microsoft Dynamics CRM avec chaque type CRM O-Auth est présentée dans cette section.

  4. Cliquez sur le lien de l’assistant de configuration Microsoft CRM…. Adobe Campaign découvre automatiquement les tables du modèle de données Microsoft Dynamics.

  5. Sélectionnez les tables à collecter.

  6. Cliquez sur Suivant pour lancer la création du schéma correspondant.

    note note
    NOTE
    Pour valider la configuration, vous devez vous déconnecter/reconnecter à la console Adobe Campaign.

    Vous pouvez vérifier que le schéma de données correspondant est disponible dans Adobe Campaign.

  7. Cliquez sur le lien Synchronisation des énumérations… pour lancer la synchronisation des énumérations entre Adobe Campaign et Microsoft Dynamics.

Campaign et Microsoft Dynamics sont maintenant connectés. Vous pouvez configurer la synchronisation des données entre les deux systèmes. Pour en savoir plus, consultez la section Synchronisation des données.

NOTE
Vous devez veiller à ajouter à la liste autorisée deux URL : l’URL du serveur et login.microsoftonline.com dans la configuration du serveur. Pour plus d’informations sur la façon de configurer les autorisations d’URL, consultez cette page.

Types de données de champ pris en charge ms-dyn-supported-types

Pour Microsoft Dynamics 365, les types d'attribut pris en charge/non pris en charge sont répertoriés ci-dessous :

Type d'attribut
Pris en charge
Types simples : booléen, date et heure, nombre décimal, nombre à virgule flottante, doublon, nombre entier, entier long, chaîne
Oui
Devise (en tant que doublon)
Oui
mémo, nom de l'entité, clé primaire, identifiant unique (en tant que chaînes)
Oui
Statut, liste de sélection (les valeurs possibles sont stockées dans des énumérations), état (chaîne)
Oui
propriétaire (comme chaîne)
Oui
Recherche (seules les recherches de référence d'entité unique)
Oui
client
Non
Concernant
Non
PartyList
Non
ManagedProperty
Non
Groupe d’options de sélection multiple
Non
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1