Integración con Salesforce

La integración de Salesforce con AEM proporciona capacidades de administración de posibles clientes y aprovecha las capacidades existentes que Salesforce proporciona de forma predeterminada. Puede configurar AEM para anunciar posibles clientes en Salesforce y crear componentes que accedan a los datos directamente desde Salesforce.

La integración bidireccional y extensible entre AEM y Salesforce permite:

  • Organizaciones para utilizar y actualizar los datos completamente para mejorar la experiencia del cliente.
  • Participación de actividades de marketing a actividades de ventas.
  • Organizaciones para transmitir y recibir automáticamente datos de un almacén de datos de Salesforce.

En este documento se describe lo siguiente:

  • cómo configurar los Cloud Services de Salesforce (configure AEM para integrarlos con Salesforce).
  • cómo usar la información de posible cliente/contacto de Salesforce en Client Context y para personalización.
  • cómo utilizar el modelo de flujo de trabajo de Salesforce para anunciar AEM usuarios como posibles clientes para salesforce.
  • cómo crear un componente que muestre datos de Salesforce.

Configuración de AEM para integrar con Salesforce

Para configurar AEM para integrarlos con Salesforce, primero debe configurar una aplicación de acceso remoto en Salesforce. A continuación, configure el servicio de nube de salesforce para que apunte a esta aplicación de acceso remoto.

NOTA

Puede crear una cuenta de desarrollador gratuita en Salesforce.

Para configurar AEM para integrar con Salesforce:

PRECAUCIÓN

Debe instalar el API de Salesforce Force antes de continuar con el procedimiento. Para obtener más información sobre cómo trabajar con paquetes, consulte la Cómo trabajar con paquetes página.

  1. En AEM, vaya a Cloud Services. En Servicios de terceros, haga clic en Configurar ahora en Salesforce.

    chlimage_1-70

  2. Cree una nueva configuración, por ejemplo, desarrollador.

    NOTA

    La nueva configuración redirige a una nueva página: http://localhost:4502/etc/cloudservices/salesforce/developer.html. Este es exactamente el mismo valor que debe especificar en la URL de devolución de llamada al crear la aplicación de acceso remoto en Salesforce. Estos valores deben coincidir.

  3. Inicie sesión en su cuenta de Salesforce (o si no tiene una, cree una en https://developer.force.com.)

  4. En Salesforce, vaya a Crear > Aplicaciones para llegar a Aplicaciones conectadas (en versiones anteriores de salesforce, el flujo de trabajo era Implementación > Acceso remoto).

  5. Haga clic en Nuevo para conectar AEM con Salesforce.

    chlimage_1-71

  6. Introduzca la variable Nombre de la aplicación conectada, Nombre de API y Correo electrónico del contacto. Seleccione el Habilitar la configuración de OAuth y escriba la URL de devolución de llamada y añada un ámbito OAuth (por ejemplo, acceso completo). La URL de rellamada tiene un aspecto similar al siguiente: http://localhost:4502/etc/cloudservices/salesforce/developer.html

    Cambie el nombre del servidor/número de puerto y el nombre de página para que coincidan con la configuración.

    chlimage_1-72

  7. Haga clic en Guardar para guardar la configuración de salesforce. Salesforce crea un clave del cliente y secreto de cliente, que necesita para AEM configuración.

    chlimage_1-73

    NOTA

    Es posible que tenga que esperar varios minutos (hasta 15 minutos) para que la aplicación de acceso remoto de Salesforce se active.

  8. En AEM, vaya a Cloud Services y vaya a la configuración de salesforce que creó anteriormente (por ejemplo, desarrollador). Haga clic en Editar e introduzca la clave de cliente y el secreto de cliente de salesforce.com.

    imagen_1-15

    URL de inicio de sesión Este es el extremo de autorización de Salesforce. Su valor es precargado y sirve para la mayoría de los casos.
    Clave del cliente Introduzca el valor obtenido de la página Registro de Aplicación de Acceso Remoto en salesforce.com
    Secreto del cliente Introduzca el valor obtenido de la página Registro de Aplicación de Acceso Remoto en salesforce.com
  9. Haga clic en Conectarse a Salesforce para conectarse. Salesforce solicita que la configuración se conecte a salesforce.

    chlimage_1-74

    En AEM, se abre un cuadro de diálogo de confirmación que le indica que se ha conectado correctamente.

  10. Vaya a la página raíz del sitio web y haga clic en Propiedades de página. A continuación, seleccione Cloud Services y agregue Salesforce y seleccione la configuración correcta (por ejemplo, desarrollador).

    chlimage_1-75

    Ahora puede utilizar el modelo de flujo de trabajo para anunciar posibles clientes en Salesforce y crear componentes que accedan a los datos de Salesforce.

Exportación de AEM usuarios como posibles clientes de Salesforce

Si desea exportar un usuario AEM como posible cliente de salesforce, debe configurar el flujo de trabajo para que publique posibles clientes en salesforce.

Para exportar AEM usuarios como posible cliente de Salesforce:

  1. Vaya al flujo de trabajo de Salesforce en http://localhost:4502/workflow haciendo clic con el botón derecho en el flujo de trabajo Exportación de Salesforce.com y haga clic en Inicio.

    chlimage_1-76

  2. Seleccione el AEM usuario que desea crear como posible cliente como el Carga útil para este flujo de trabajo (inicio -> usuarios). Asegúrese de seleccionar el nodo de perfil del usuario, ya que contiene información como givenName, familyName, etc., que están asignados a los posibles clientes de Salesforce Nombre y Apellido campos.

    chlimage_1-77

    NOTA

    Antes de iniciar este flujo de trabajo, hay ciertos campos obligatorios que un nodo de AEM debe tener antes de publicarse en Salesforce. Estos son givenName, familyName, empresa y email. Para ver una lista completa de asignación entre AEM usuario y el posible cliente de Salesforce, consulte Configuración de asignación entre AEM usuario y el posible cliente de Slaesforce.

  3. Haga clic en Aceptar. La información del usuario se exporta a salesforce.com. Puede verificarlo en salesforce.com.

    NOTA

    Los registros de errores le mostrarán si se ha importado un posible cliente. Consulte el registro de errores para obtener más información.

Configuración del flujo de trabajo de exportación de Salesforce.com

Es posible que deba configurar el flujo de trabajo de exportación de Salesforce.com para que coincida con la configuración correcta de Salesforce.com o para realizar otros cambios.

Para configurar el flujo de trabajo de exportación de Salesforce.com:

  1. Vaya a http://localhost:4502/cf#/etc/workflow/models/salesforce-com-export.html.

    imagen_1-16

  2. Abra el paso Exportar de Salesforce.com y seleccione la opción Argumentos , seleccione la configuración correcta y haga clic en OK. Además, si desea que el flujo de trabajo vuelva a crear un posible cliente eliminado en Salesforce, active la casilla de verificación.

    chlimage_1-78

  3. Haga clic en Guardar para guardar los cambios.

    chlimage_1-79

Asignación de la configuración entre AEM usuario y el posible cliente de Salesforce

Para ver o editar la configuración de asignación actual entre un usuario AEM y un posible cliente de Salesforce, abra el Administrador de configuración: https://<hostname>:<port>/system/console/configMgr y busque Configuración de asignación de posibles clientes de Salesforce.

  1. Abra el Administrador de configuración haciendo clic en Consola web o vaya directamente a https://<hostname>:<port>/system/console/configMgr.

  2. Buscar Configuración de asignación de posibles clientes de Salesforce.

    chlimage_1-80

  3. Cambie las asignaciones según sea necesario. La asignación predeterminada sigue el patrón aemUserAttribute=sfLeadAttribute. Haga clic en Guardar para guardar los cambios.

Configuración del almacén de contexto del cliente de Salesforce

El almacén de contexto de cliente de salesforce muestra información adicional sobre el usuario que ha iniciado sesión actualmente que está disponible en AEM. Obtiene esta información adicional de Salesforce según la conexión del usuario con Salesforce.

Para ello, debe configurar lo siguiente:

  1. Vincule un usuario AEM con un ID de Salesforce a través del componente Connect de Salesforce.
  2. Agregue los datos de perfil de Salesforce a la página de contexto del cliente para configurar las propiedades que desea ver.
  3. (Opcional) Genere un segmento que utilice los datos del almacén de contexto del cliente de Salesforce.

Vinculación de un usuario de AEM con un ID de Salesforce

Debe asignar un usuario AEM con un ID de Salesforce para cargarlo en ClientContext. En un escenario real, vincularía basándose en los datos conocidos del usuario con la validación. Para fines de demostración, en este procedimiento se usa la variable Salesforce Connect componente.

  1. Vaya a un sitio web en AEM, inicie sesión y arrastre y suelte el Salesforce Connect de la barra de tareas.

    NOTA

    Si la variable Salesforce Connect no está disponible, vaya a Diseño visualícelo y selecciónelo para que esté disponible en Editar vista.

    chlimage_1-17

    Cuando arrastra el componente a la página, se muestra Vínculo a Salesforce=Off.

    chlimage_1-81

    NOTA

    Este componente es solo para fines de demostración. Para escenarios reales, habría otro proceso para vincular/relacionar usuarios con posibles clientes.

  2. Después de arrastrar el componente en la página, ábralo para configurarlo. Seleccione la configuración, el tipo de contacto y el posible cliente o contacto de Salesforce y haga clic en OK.

    chlimage_1-82

    AEM vincula al usuario con el contacto o posible cliente de Salesforce.

    chlimage_1-83

Adición de datos de Salesforce al contexto de cliente

Puede cargar datos de usuario de Salesforce en Client Context para utilizarlos en la personalización:

  1. Abra el contexto de cliente que desee ampliar navegando allí, por ejemplo, http://localhost:4502/etc/clientcontext/default/content.html.

    chlimage_1-18

  2. Arrastre el Datos de perfil de Salesforce a ClientContext.

    chlimage_1-19

  3. Haga doble clic en el componente para abrirlo. Select Agregar elemento y seleccione una propiedad en la lista desplegable. Añada tantas propiedades como desee y seleccione OK.

    chlimage_1-84

  4. Ahora, verá las propiedades específicas de Salesforce de Salesforce en el contexto del cliente.

    chlimage_1-85

Creación de un segmento utilizando datos del almacén de contexto del cliente de Salesforce

Puede crear un segmento que utilice datos del almacén de contexto del cliente de Salesforce. Para ello:

  1. Vaya a la segmentación en AEM, ya sea accediendo a Herramientas > Segmentación o yendo a http://localhost:4502/miscadmin#/etc/segmentation.
  2. Cree o actualice un segmento para incluir datos de Salesforce. Para obtener más información, consulte Segmentación.

Búsqueda de posibles clientes

AEM se envía con un componente de búsqueda de muestra que busca posibles clientes en Salesforce según los criterios dados. Este componente muestra cómo utilizar la API de REST de Salesforce para buscar objetos de salesforce. Debe vincular una página con una configuración de Salesforce para activar una llamada a salesforce.com.

NOTA

Este es un componente de ejemplo que muestra cómo utilizar la API de REST de Salesforce para consultar los objetos de Salesforce. Utilícelo como ejemplo para crear componentes más complejos según sus necesidades.

Para utilizar este componente:

  1. Desplácese a la página donde desee utilizar esta configuración. Abra las propiedades de página y seleccione Cloud Services. Haga clic en Agregar servicios y seleccione Salesforce y la configuración adecuada y haga clic en OK.

    chlimage_1-20

  2. Arrastre el componente de búsqueda de Salesforce a la página (siempre que se haya activado). Para activarlo, vaya al modo Diseño y añádalo al área adecuada).

    imagen_1-21

  3. Abra el componente Buscar , especifique los parámetros de búsqueda y haga clic en OK.

    chlimage_1-86

  4. AEM muestra los posibles clientes especificados en el componente de búsqueda que coinciden con los criterios especificados.

    chlimage_1-87

En esta página