Enviar registros de objetos de Salesforce cambiados a una base de datos a través de un flujo de Salesforce utilizando Jitterbit Integration Studio y API Manager

Introducción

Este patrón de diseño de integración configura un flujo de Salesforce que envía un mensaje saliente a un API de API Manager cuando un objeto cambia (en este ejemplo, el objeto Cuenta). Un proyecto de Integration Studio procesa el mensaje saliente de Salesforce, mapea los datos del objeto y los guarda en una base de datos.

Para configurar este patrón, sigue estas secciones en orden:

• Parte 1: En Salesforce, configura un mensaje saliente y un flujo para llamarlo cuando un objeto cambie, y descarga el archivo WSDL que define el mensaje.
• Parte 2: En Integration Studio, configura una cadena de operación para recibir el mensaje saliente de Salesforce y almacenar los valores mapeados en una base de datos.
• Parte 3: En API Manager, configura una API como un punto final para Salesforce.
• Parte 4: Regresa a Salesforce para activar el flujo, luego prueba el patrón de diseño de integración completado.

Parte 1: Flujo de Salesforce y archivo WSDL

1. En Salesforce, selecciona Configuración > Herramientas de Plataforma > Automatización de Procesos > Acciones de Flujo de Trabajo > Mensajes Salientes.

2. Haz clic en el botón Nuevo Mensaje Saliente (destacado en la imagen a continuación).

   

3. En la página Nuevo Mensaje Saliente, haz clic en el menú Objeto, selecciona Cuenta, y luego haz clic en Siguiente.

   

4. En la página de Nuevo Mensaje Saliente, ingresa valores para lo siguiente y luego haz clic en Guardar:

   • Nombre: Tu elección de nombre.
   • Nombre Único: Este nombre se genera automáticamente basado en el valor de Nombre y las reglas de nomenclatura del campo.
   • Descripción: (Opcional) Una descripción para este mensaje saliente.
   • URL del Endpoint: example.com. Esta URL temporal se actualizará más tarde.
   • Usuario para Enviar Como: Ingresa el usuario que envía el mensaje saliente. El valor predeterminado es tu nombre de usuario de Salesforce.
   • Componente Protegido: No seleccionado.
   • Enviar ID de Sesión: No seleccionado.
   • Campos de Cuenta a Enviar: Selecciona los campos del objeto a enviar. En este ejemplo, solo se seleccionan Nombre y Teléfono. El campo Id se selecciona automáticamente, porque es el campo clave para el objeto.

   

5. En la página de Detalles del Mensaje Saliente del Flujo, haz clic en el enlace Haz clic para WSDL en la fila etiquetada como Endpoint WSDL (resaltada en la imagen a continuación).

   

6. Se abre un archivo XML en una nueva ventana del navegador. Guarda el archivo con una extensión .wsdl. Dependiendo de tu sistema operativo, es posible que debas establecer la extensión del archivo después de descargarlo.

7. En la ventana del navegador de Salesforce, selecciona Configuración > Herramientas de Plataforma > Automatización de Procesos > Flujos.

8. En la página de Flujos, haz clic en el botón Nuevo Flujo (resaltado en la imagen a continuación).

   

9. En el cuadro de diálogo Nuevo Flujo del Constructor de Flujos, selecciona la pestaña Núcleo, selecciona Flujo Activado por Registro, y luego haz clic en Crear.

   

10. En el cuadro de diálogo Configurar Inicio, ingresa valores para lo siguiente y luego haz clic en Listo:

    • Seleccionar Objeto: En el campo Objeto, ingresa Cuenta.
    • Configurar Disparador: Para Disparar el Flujo Cuando, selecciona Se Crea o Actualiza un Registro.
    • Establecer Condiciones de Entrada: Para Requisitos de Condición, deja el valor como Ninguno.
    • Optimizar el Flujo Para: Selecciona Acciones y Registros Relacionados.

    

11. En la página de Constructor de Flujos, pasa el cursor sobre el nodo entre Inicio y Fin (indicado por una flecha roja en la imagen a continuación), luego haz clic en Agregar Elemento.

    

12. En el cuadro de diálogo Agregar Elemento, selecciona Acción.

    

13. En el cuadro de diálogo Nueva Acción, selecciona la categoría Mensaje Saliente.

    

14. Haz clic en la barra de búsqueda de Acción, luego selecciona tu mensaje saliente. Ingresa valores para lo siguiente, luego haz clic en Listo:

    • Etiqueta: Ingresa una etiqueta para la acción.
    • Nombre de API: Este nombre se genera automáticamente basado en el valor de Etiqueta y las reglas de nomenclatura del campo.
    • Descripción: (Opcional) Ingresa una descripción para esta acción.

    

15. En la página de Constructor de Flujos, haz clic en Guardar.

    

16. En el cuadro de diálogo Guardar el Flujo, ingresa valores para lo siguiente, luego haz clic en Guardar:

    • Etiqueta del Flujo: Ingresa una etiqueta para el flujo.
    • Nombre de API del Flujo: Este nombre se genera automáticamente basado en el valor de Etiqueta del Flujo y las reglas de nomenclatura del campo.
    • Descripción: (Opcional) Ingresa una descripción para este flujo.

    

Parte 2: Operaciones de Integration Studio

Definir la operación 'Mensaje Saliente de Salesforce'

1. Crea un nuevo proyecto de Integration Studio.

2. Arrastra una actividad de Solicitud SOAP desde la paleta de componentes de diseño y suéltala en una operación vacía en el lienzo de diseño.

3. Establece el nombre de la operación como Mensaje Saliente de Salesforce.
4. Haz doble clic en la instancia de actividad Solicitud SOAP en la operación para abrir su pantalla de configuración.
5. En el paso 1, selecciona Subir Archivo, haz clic en Examinar, selecciona el archivo WSDL previamente descargado, luego haz clic en Subir.
6. Haz clic en Puerto y selecciona Notificación (la única opción). Los campos restantes se completan automáticamente y no necesitan más edición.

7. Haz clic en Siguiente.

   

8. En el paso 2, haz clic en Finalizado.

   

9. Agrega una nueva transformación a la derecha de la actividad SOAP Request.

10. Para el esquema de destino, haz clic en Espejar Esquema de Origen.
11. Haz clic en Automapear Coincidencias Exactas, o mapea manualmente los campos de origen a los de destino.

12. En el esquema de destino, haz clic en Editar Esquema, establece el nombre del esquema como Esquema de Upsert, y luego haz clic en Guardar Cambios.

    

13. Cierra la transformación para regresar al flujo de trabajo.

    

14. En la categoría Conectores de la paleta de componentes, encuentra y haz clic en el conector Variable.

15. Deja los nombres de conexión y variable con sus valores predeterminados, y luego haz clic en Guardar Cambios.
16. Arrastra una actividad de escritura de Variable desde la paleta de componentes y suéltala sobre la operación Mensaje Saliente de Salesforce, a la derecha de la transformación.
17. Haz doble clic en la actividad Escribir.

18. En el paso 1, selecciona Sí, Usar Esquema Guardado, haz clic en Esquemas Guardados, selecciona Esquema de Upsert, y luego haz clic en Siguiente.

    

19. En el paso 2, haz clic en Finalizado.

    

    La operación Mensaje Saliente de Salesforce:

    

Define la operación 'Respuesta de Salesforce'

1. Arrastra una actividad de respuesta SOAP desde la paleta de componentes y suéltala en una operación vacía en el lienzo de diseño.
2. Establece el nombre de la operación como Respuesta de Salesforce.
3. Haz doble clic en la actividad Respuesta SOAP.

4. En el paso 1, selecciona Seleccionar existente, selecciona el archivo WSDL previamente cargado y luego haz clic en Siguiente.

   

5. En el paso 2, haz clic en Finalizado.

   

6. Agrega una nueva transformación a la izquierda de la actividad Respuesta SOAP en la operación Respuesta de Salesforce.

7. Agrega un valor personalizado al campo Ack con el valor true, luego cierra la transformación para regresar al flujo de trabajo.

   

   La operación Respuesta de Salesforce:

   

Define la operación 'Upsert de Base de Datos'

1. Arrastra una actividad de lectura de variable desde la paleta de componentes y suéltala en una operación vacía en el lienzo de diseño.
2. Establece el nombre de la operación como Upsert de Base de Datos.
3. Haz doble clic en la actividad Leer.

4. En el paso 1, selecciona Sí, usar esquema guardado, haz clic en Esquemas guardados, selecciona Esquema de Upsert, y luego haz clic en Siguiente.

   

5. En el paso 2, haz clic en Finalizado.

   

6. Configura una conexión a la base de datos para tu base de datos de destino, luego haz clic en Guardar cambios. (Se muestra una conexión a un servidor PostgreSQL en este ejemplo.)

   

7. Arrastra una actividad de Base de Datos Upsert desde la paleta de componentes y suéltala en la operación de Base de Datos Upsert, a la derecha de la actividad Leer.

8. Haz doble clic en la actividad Upsert.

9. En el paso 1, haz clic en Actualizar, selecciona la tabla de base de datos de destino y luego haz clic en Siguiente.

   

10. En el paso 2, selecciona las columnas que se actualizarán y luego haz clic en Siguiente.

    

11. En el paso 3, haz clic en Finalizado.

    

12. En la operación de Base de Datos Upsert, agrega una nueva transformación entre las actividades Leer y Upsert.

13. Mapea manualmente los campos del objeto fuente de Salesforce a las columnas de la base de datos de destino, luego cierra la transformación para regresar al flujo de trabajo.

    

    La operación de Base de Datos Upsert:

    

Acciones de operación y despliegue

1. Abre la pantalla de configuración para la operación de Mensaje Saliente de Salesforce.
2. Selecciona la pestaña Acciones, luego establece los siguientes valores de campo:
   • Condición: En Éxito.
   • Acción: Ejecutar Operación.
   • Operación: Respuesta de Salesforce.

3. Haz clic en + Agregar Acción, luego cierra la pantalla de configuración de la operación.

   

4. Abre la pantalla de configuración para la operación de Respuesta de Salesforce.

5. Selecciona la pestaña Acciones, luego establece los siguientes valores de campo:
   • Condición: En Éxito.
   • Acción: Ejecutar Operación.
   • Operación: Base de Datos Upsert.

6. Haz clic en + Agregar Acción, luego cierra la pantalla de configuración de la operación.

   

   El proyecto completado, antes de la implementación:

   

7. Implementar el proyecto.

Parte 3: API Manager API

1. En API Manager, selecciona APIs, luego haz clic en Nueva API.

2. En el paso 1 de la página Publicar Nueva API, ingresa valores para lo siguiente, luego haz clic en Siguiente:

   • Nombre de la API: Ingresa un nombre para la API.

   • Entorno: Selecciona el entorno donde se implementó el proyecto de Integration Studio.

   • Raíz del Servicio: Deja el valor inicial derivado del nombre de la API.

   • Número de Versión: (Opcional) Ingresa un número de versión de la API.

   • Descripción: (Opcional) Ingresa una descripción para esta API.

   

3. En el paso 2, selecciona API Personalizada como el Tipo de Servicio y luego haz clic en Agregar Servicio API. Para el nuevo servicio API, ingresa estos valores para los siguientes campos, haz clic en Guardar, y luego haz clic en Siguiente:

   • Método de Solicitud: Usa el menú para seleccionar el método de solicitud POST para el servicio API. Por defecto, el método de solicitud está configurado en GET.

   • Nombre del Servicio: Ingresa un nombre de servicio.

   • En la pestaña Operación, selecciona estos valores:

     • Asignar Proyecto: Desde el menú, selecciona tu proyecto de Integration Studio.

     • Asignar Operación(es):

       • Operación: Selecciona la operación Mensaje Saliente de Salesforce.

       • Tipo de Respuesta: Selecciona Destino Final como el tipo de respuesta.

   

4. En el paso 3, haz clic en Saltar Este Paso.

5. En el paso 4, haz clic en Guardar y Publicar.

   

6. En el diálogo titulado ¡Todo listo, tu API está activa!, haz clic en Copiar URL, luego haz clic en Descartar.

Parte 4: Actualizar la URL del endpoint de Salesforce y activar el flujo

1. En Salesforce, selecciona Configuración > Herramientas de Plataforma > Automatización de Procesos > Acciones de Flujo > Mensajes Salientes.
2. En la página de Mensajes Salientes, haz clic en Editar para tu mensaje saliente.

3. Reemplaza el contenido del campo URL del Endpoint (resaltado en la imagen a continuación) con la URL copiada al final de la sección anterior, luego haz clic en Guardar.

   

4. Selecciona Configuración > Herramientas de Plataforma > Automatización de Procesos > Flujos.

5. Haz clic en la etiqueta del flujo para la entrada Flujo de Jitterbit (resaltado en la imagen a continuación).

   

6. En la página de Constructor de Flujos, haz clic en el botón Activar (resaltado en la imagen a continuación).

   

Probar la integración

Para probar este patrón de diseño de integración, sigue estos pasos:

1. En Salesforce, abre la aplicación Servicio, luego selecciona la pestaña Cuentas.
2. Edita un contacto de cuenta y luego guárdalo.
3. Inicia sesión en tu base de datos y consulta la tabla de destino.