Connecter Campaign et Microsoft Dynamics 365

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

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 tables et synchroniser des énumérations
4. Création du workflow de synchronisation

En savoir plus dans cette section

Configurer Microsoft Dynamics CRM

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 de connexion d'administrateur global. Suivez ensuite les étapes décrites ci-dessous.

Obtention de l'identifiant du client Microsoft Dynamics

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é

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 :

   - openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
   

   REMARQUE

   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

É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

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

   REMARQUE

   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

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.

   REMARQUE

   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.

   

   REMARQUE

   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.

Types de données de champ pris en charge

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

Ressources Business.Adobe.com