Intégration à Salesforce

Dernière mise à jour : 2023-12-04

L’intégration de Salesforce à Adobe Experience Manager (AEM) fournit des fonctionnalités de gestion des prospects et utilise les fonctionnalités existantes prêtes à l’emploi fournies par Salesforce. Vous pouvez configurer AEM pour publier des prospects sur Salesforce et créer des composants qui accèdent directement aux données à partir de Salesforce.

L’intégration bidirectionnelle et extensible entre AEM et Salesforce permet :

  • Les entreprises doivent utiliser et modifier entièrement les données pour améliorer l’expérience client.
  • Engagement du marketing aux activités de vente.
  • Les organisations doivent transmettre et recevoir automatiquement des données d’une banque de données Salesforce.

Ce document répond aux questions suivantes :

  • Configuration des Cloud Service Salesforce (configuration d’AEM à intégrer à Salesforce).
  • utilisation des informations de prospect/contact Salesforce dans ClientContext et pour la personnalisation.
  • Découvrez comment utiliser le modèle de workflow Salesforce pour publier AEM utilisateurs comme des prospects pour Salesforce.
  • Découvrez comment créer un composant qui affiche les données de Salesforce.

Configuration d’AEM à intégrer à Salesforce

Pour configurer AEM à intégrer avec Salesforce, vous devez d’abord configurer une application d’accès à distance dans Salesforce. Ensuite, vous configurez le service cloud Salesforce pour qu’il pointe vers cette application d’accès à distance.

REMARQUE

Vous pouvez créer un compte développeur gratuit dans Salesforce.

Pour configurer AEM à intégrer à Salesforce :

ATTENTION

Installez le API Salesforce module d’intégration avant de poursuivre la procédure. Pour plus d’informations sur l’utilisation des packages, consultez la page Utilisation des packages

  1. Dans AEM, accédez à Services cloud. Dans Services tiers, cliquez sur Configurer maintenant dans Salesforce.

    chlimage_1-70

  2. Créez une configuration, par exemple : développeur.

    REMARQUE

    La nouvelle configuration redirige vers une nouvelle page : http://localhost:4502/etc/cloudservices/salesforce/developer.html. Il s’agit de la même valeur que celle que vous devez spécifier dans l’ URL de rappel lors de la création de l’application d’accès à distance dans Salesforce. Ces valeurs doivent correspondre.

  3. Connectez-vous à votre compte Salesforce (ou si vous n’en avez pas, créez-en un à l’adresse https://developer.salesforce.com.)

  4. Dans Salesforce, accédez à Créer > Applications pour accéder à Applications connectées (dans les anciennes versions de Salesforce, le processus était Déployer > Accès distant).

  5. Cliquez sur Nouveau vous pouvez donc connecter AEM avec Salesforce.

    chlimage_1-71

  6. Saisissez le nom de l’application connectée, le nom de l’API et l’adresse électronique de contact. Cochez la case Activer les paramètres OAuth, saisissez l’adresse URL de rappel et ajoutez une portée OAuth (accès intégral, par exemple). L’adresse URL de rappel se présente comme suit : http://localhost:4502/etc/cloudservices/salesforce/developer.html.

    Modifiez le nom et le numéro de port du serveur et le nom de la page correspondant à votre configuration.

    chlimage_1-72

  7. Cliquez sur Enregistrer pour enregistrer la configuration Salesforce. Salesforce crée une clé du client et un secret du client, dont vous avez besoin pour la configuration d’AEM.

    chlimage_1-73

    REMARQUE

    Patientez plusieurs minutes (jusqu’à 15 minutes) pour que l’application d’accès à distance dans Salesforce soit activée.

  8. Dans AEM, accédez à Cloud Service et accédez à la configuration Salesforce que vous avez créée précédemment (par exemple, développeur). Cliquez sur Modifier et saisissez la clé du client et le secret client à partir de salesforce.com.

    chlimage_1-15

    URL de connexion Il s’agit du point d’entrée d’autorisation Salesforce. Sa valeur est prérenseignée et convient dans la plupart des cas.
    Clé du client Saisissez la valeur obtenue à partir de la page Enregistrement de l’application d’accès à distance dans salesforce.com
    Secret du client Saisissez la valeur obtenue à partir de la page Enregistrement de l’application d’accès à distance dans salesforce.com
  9. Cliquez sur Connexion à Salesforce pour vous connecter. Salesforce vous demande d’autoriser votre configuration à vous connecter à Salesforce.

    chlimage_1-74

    Dans AEM, une boîte de dialogue de confirmation s’affiche pour confirmer que vous êtes bien connecté.

  10. Accédez à la page principale de votre site web et cliquez sur Propriétés de la page. Ensuite, sélectionnez Services cloud, ajoutez Salesforce et sélectionnez la configuration appropriée (par exemple, développeur).

    chlimage_1-75

    Vous pouvez maintenant utiliser le modèle de workflow pour publier des prospects sur Salesforce et créer des composants qui accèdent aux données de Salesforce.

Exportation des utilisateurs AEM en tant que prospects Salesforce

Si vous souhaitez exporter un utilisateur AEM en tant que prospect Salesforce, configurez le workflow pour publier des prospects vers Salesforce.

Pour exporter AEM utilisateurs en tant que prospects Salesforce, procédez comme suit :

  1. Accédez au workflow Salesforce à l’adresse http://localhost:4502/workflow en cliquant avec le bouton droit sur le workflow Exportation de Salesforce.com et en cliquant sur Démarrer.

    chlimage_1-76

  2. Sélectionnez l’utilisateur AEM que vous souhaitez créer en tant que prospect en tant que Payload pour ce workflow (accueil > utilisateurs). Veillez à sélectionner le noeud de profil de l’utilisateur, car il contient des informations telles que givenName, et familyName, qui sont mappés aux pistes Salesforce FirstName et LastName des champs.

    chlimage_1-77

    REMARQUE

    Avant de lancer ce workflow, le nœud de prospect dans AEM doit comporter certains champs obligatoires avant d’être publié dans Salesforce. Voici les givenName, familyName, société, et email. Pour obtenir une liste complète des mappages entre l’utilisateur AEM et le prospect Salesforce, reportez-vous à la section Mappage Configuration entre l’utilisateur AEM et le prospect Salesforce.

  3. Cliquez sur OK. Les informations de l’utilisateur sont exportées vers salesforce.com. Vous pouvez le vérifier à l’adresse salesforce.com.

    REMARQUE

    Les logs d'erreur indiquent si un prospect est importé. Pour plus d’informations, consultez le journal des erreurs.

Configuration du Salesforce.com workflow d’exportation

Si nécessaire, configurez le workflow Salesforce.com Export pour qu'il corresponde à la configuration Salesforce.com correcte, ou pour apporter d'autres modifications.

Pour configurer le Salesforce.com workflow d'export :

  1. Accédez à http://localhost:4502/cf#/etc/workflow/models/salesforce-com-export.html..

    chlimage_1-16

  2. Ouvrez l’étape d’exportation de salesforce.com, sélectionnez l’onglet Arguments, sélectionnez la configuration appropriée et cliquez sur OK. De plus, si vous souhaitez que le workflow recrée un prospect supprimé dans Salesforce, cochez cette case.

    chlimage_1-78

  3. Cliquez sur Enregistrer pour enregistrer vos modifications.

    chlimage_1-79

Configuration du mappage entre un utilisateur AEM et un prospect Salesforce

Pour afficher ou modifier la configuration des correspondances actuelle entre un utilisateur AEM et un prospect Salesforce, ouvrez le gestionnaire de configuration :https://<hostname>:<port>/system/console/configMgr et cherchez Configuration des correspondances d’un prospect Salesforce.

  1. Ouvrez le gestionnaire de configuration en cliquant sur Console web ou en accédant directement à https://<hostname>:<port>/system/console/configMgr..

  2. Cherchez Configuration du mappage d’un prospect Salesforce.

    chlimage_1-80

  3. Modifiez les correspondances, au besoin. La correspondance par défaut suit le modèle aemUserAttribute=sfLeadAttribute. Cliquez sur Enregistrer pour enregistrer vos modifications.

Configuration du magasin de contexte client Salesforce

Le magasin de contexte client Salesforce affiche des informations supplémentaires sur l’utilisateur actuellement connecté par rapport à ce qui est déjà disponible dans AEM. Il extrait ces informations supplémentaires de Salesforce en fonction de la connexion de l’utilisateur à Salesforce.

Pour ce faire, configurez les éléments suivants :

  1. Associez un utilisateur AEM à un identifiant Salesforce via le composant Salesforce Connect.
  2. Ajoutez les données de profil Salesforce dans la page contextuelle du client afin de configurer les propriétés que vous souhaitez afficher.
  3. (Facultatif) Créez un segment qui utilise les données de l’entrepôt de contexte client Salesforce.

Liaison d’un utilisateur AEM à un identifiant Salesforce

Mappez un utilisateur AEM avec un identifiant Salesforce afin que vous puissiez le charger dans le contexte client. Dans un scénario réel, vous effectueriez la liaison en fonction des données connues de l’utilisateur avec la validation. À des fins de démonstration, dans cette procédure, vous utilisez la méthode Salesforce Connect composant.

  1. Accédez à un site web dans AEM, connectez-vous, puis faites glisser et déposez le Salesforce Connect du sidekick.

    REMARQUE

    Si la variable Salesforce Connect n’est pas disponible, accédez à la Conception et sélectionnez-la pour la rendre disponible dans le Modifier vue.

    chlimage_1-17

    Lorsque vous faites glisser le composant vers la page, il affiche Lien vers Salesforce=Désactivé.

    chlimage_1-81

    REMARQUE

    Ce composant n’est fourni qu’à titre de démonstration. Dans le cas de scénarios réels, il existe un autre processus pour lier/associer les utilisateurs à des pistes.

  2. Après avoir fait glisser le composant dans la page, ouvrez-le pour le configurer. Sélectionnez la configuration, le type de contact et le prospect ou le contact Salesforce, puis cliquez sur OK.

    chlimage_1-82

    AEM lie l’utilisateur au contact ou au prospect Salesforce.

    chlimage_1-83

Ajout de données Salesforce à ClientContext

Vous pouvez charger des données utilisateur à partir de Salesforce dans ClientContext à utiliser pour la personnalisation :

  1. Ouvrez le contexte client que vous souhaitez étendre en y accédant, par exemple : http://localhost:4502/etc/clientcontext/default/content.html.

    chlimage_1-18

  2. Faites glisser le composant Données du profil Salesforce vers le contexte du client.

    chlimage_1-19

  3. Ouvrez le composant en double-cliquant dessus. Sélectionnez Ajouter un élément et sélectionnez une propriété dans la liste déroulante. Ajoutez autant de propriétés que vous le souhaitez et sélectionnez OK.

    chlimage_1-84

  4. À présent, les propriétés spécifiques à Salesforce s’affichent dans le contexte client.

    chlimage_1-85

Création d’un segment à l’aide des données du magasin de contexte client Salesforce

Vous pouvez créer un segment qui utilise les données de l’entrepôt de contexte client Salesforce. Pour ce faire :

  1. Accédez à la segmentation dans AEM en sélectionnant Outils > Segmentation ou en consultant http://localhost:4502/miscadmin#/etc/segmentation.
  2. Créez ou mettez à jour un segment pour inclure des données de Salesforce. Pour plus d’informations, voir Segmentation.

Recherche de pistes

AEM est fourni avec un exemple de composant Recherche, qui cherche des prospects dans Salesforce en fonction des critères déterminés. Ce composant vous explique comment utiliser l’API REST Salesforce pour rechercher des objets Salesforce. Pour déclencher un appel vers salesforce.com, liez une page avec une configuration Salesforce.

REMARQUE

Voici un exemple de composant, qui montre comment utiliser l’API REST Salesforce pour créer une requête portant sur des objets Salesforce. Utilisez-le comme exemple pour créer des composants plus complexes en fonction de vos besoins.

Pour utiliser ce composant :

  1. Accédez à la page dans laquelle vous souhaitez utiliser cette configuration. Ouvrez les propriétés de la page et sélectionnez Cloud Service. Cliquez sur Ajout de services et sélectionnez Salesforce et la configuration appropriée, puis cliquez sur OK.

    chlimage_1-20

  2. Faites glisser le composant Recherche de Salesforce vers la page (sous réserver qu’elle a été activée. Pour l’activer, accédez au mode Conception et ajoutez-le à la zone appropriée).

    chlimage_1-21

  3. Ouvrez le composant Recherche, spécifiez les paramètres de recherche et cliquez sur OK.

    chlimage_1-86

  4. AEM affiche les prospects spécifiés dans votre composant Recherche correspondant aux critères spécifiés.

    chlimage_1-87

Sur cette page