Envíe registros de objetos de Salesforce modificados a una base de datos a través del 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 Manager API cuando un objeto cambia (en este ejemplo, el objeto Account). Un proyecto de Integration Studio procesa el mensaje saliente de Salesforce, asigna los datos del objeto y los guarda en una base de datos.

Nota

Enviar registros de objetos de Salesforce modificados a una base de datos a través del API Manager es un patrón de integración idéntico que utiliza una regla de Flujo de trabajo de Salesforce en lugar de un flujo.

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

• Parte 1: En Salesforce, configure un mensaje saliente y un flujo para llamarlo cuando un objeto cambia, y descargue el archivo WSDL que define el mensaje.
• Parte 2: En Integration Studio, configure una cadena de operación para recibir el mensaje saliente de Salesforce y almacene los valores asignados en una base de datos.
• Parte 3: En API Manager, configure una API como extremo para Salesforce.
• Parte 4: Regrese a Salesforce para activar el flujo y luego pruebe el patrón de diseño de integración completado.

Parte 1: Flujo de Salesforce y archivo WSDL

1. En Salesforce, seleccione Configuración > Herramientas de la plataforma > Automatización de procesos > Acciones de Flujo de trabajo > Mensajes salientes.

2. Haga clic en el botón Nuevo mensaje saliente (resaltado en la imagen a continuación).

   

3. En la página Nuevo mensaje saliente, haga clic en el menú Objeto, seleccione Cuenta y haga clic en Siguiente.

   

4. En la página Nuevo mensaje saliente, ingrese valores para lo siguiente y luego haga clic en Guardar:

   • Nombre: El nombre que elijas.
   • Nombre único: Este nombre se genera automáticamente en función del valor de Nombre y las reglas de nombres del campo.
   • Descripción: (Opcional) Una descripción para este mensaje saliente.
   • URL del Extremo: example.com. Esta URL temporal se actualiza posteriormente.
   • Usuario de envío: Ingrese el usuario que envía el mensaje saliente. El valor predeterminado es su nombre de usuario de Salesforce.
   • Componente protegido: No seleccionado.
   • Enviar ID de sesión: No seleccionado.
   • Campos de cuenta para enviar: Seleccione los campos del objeto que desea enviar. En este ejemplo, solo se seleccionaron Nombre y Teléfono. El campo Id se selecciona automáticamente, ya que es el campo clave del objeto.

   

5. En la página Detalles del mensaje saliente del Flujo de trabajo del mensaje, haga clic en el enlace Haga clic para WSDL en la fila denominada WSDL del Extremo (resaltado en la imagen a continuación).

   

6. Se abrirá un archivo XML en una nueva ventana del navegador. Guarde el archivo con un .wsdl Extensión. Dependiendo de su sistema operativo, es posible que tenga que configurar la extensión del archivo después de descargarlo.

7. En la ventana del navegador de Salesforce, seleccione Configuración > Herramientas de plataforma > Automatización de procesos > Flujos.

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

   

9. En el cuadro de diálogo Nuevo flujo del Generador de flujos, seleccione la pestaña Núcleo, seleccione Flujo activado por registro y, a continuación, haga clic en Crear.

   

10. En el cuadro de diálogo Configurar inicio, introduzca los siguientes valores y haga clic en Listo:

    • Seleccionar objeto: En el campo Objeto, introduzca Cuenta.
    • Configurar desencadenador: En Activar el flujo cuando, seleccione Se crea o actualiza un registro.
    • Establecer condiciones de entrada: En Requisitos de condición, deje el valor en Ninguno.
    • Optimizar el flujo para: Seleccione Acciones y registros relacionados.

    

11. En la página Generador de Flujos, coloque el cursor sobre el nodo entre Inicio y Fin (indicado por una flecha roja en la imagen de abajo) y haga clic en Añadir elemento.

    

12. En el cuadro de diálogo Agregar elemento, seleccione Acción.

    

13. En el cuadro de diálogo Nueva acción, seleccione la categoría Mensaje saliente.

    

14. Haga clic en la barra de búsqueda Acción y seleccione su mensaje saliente. Introduzca los valores siguientes y haga clic en Listo:

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

    

15. En la página Generador de flujo, haga clic en Guardar.

    

16. En el cuadro de diálogo Guardar el flujo, ingrese valores para lo siguiente y luego haga clic en Guardar:

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

    

Parte 2: Operaciones de Integration Studio

Definir la operación 'Mensaje saliente de Salesforce '

1. Cree un nuevo proyecto de Integration Studio.

2. Arrastre una actividad de solicitud SOAP de la paleta de componentes de diseño y suéltelo en una operación vacía en el tela de diseño.

3. Establezca el nombre de la operación en Mensaje saliente de Salesforce.
4. Haga 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, seleccione Cargar archivo, haga clic en Explorar, seleccione el archivo WSDL previamente descargado y luego haga clic en Cargar.
6. Haga clic en Puerto y seleccione Notificación (la única opción). Los campos restantes se completan automáticamente y no requieren más edición.

7. Haga clic en Siguiente.

   

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

   

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

10. Para el esquema de destino, haga clic en Esquema de origen reflejado.
11. Haga clic en Autoasignar coincidencias exactas o asignar manualmente campos de origen a destino.

12. En el esquema de destino, haga clic en Editar esquema, establezca el nombre del esquema en Upsert Schema y luego haga clic en Guardar cambios.

    

13. Cierre la transformación para volver al flujo de trabajo.

    

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

15. Deje los nombres de conexión y variable con sus valores predeterminados y haga clic en Guardar cambios.
16. Arrastre una Actividad de escritura de variable de la paleta de componentes y suéltelo en la operación Mensaje saliente de Salesforce, a la derecha de la transformación.
17. Haga doble clic en la actividad Escribir.

18. En el paso 1, seleccione Sí, usar esquema guardado, haga clic en Esquemas guardados, seleccione Insertar esquema y luego haga clic en Siguiente.

    

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

    

    La operación Mensaje saliente de Salesforce:

    

Definir la operación ' Salesforce Response'

1. Arrastre una actividad de respuesta SOAP de la paleta de componentes y suéltelo en una operación vacía en el tela de diseño.
2. Establezca el nombre de la operación en Salesforce Response.
3. Haga doble clic en la actividad Respuesta SOAP.

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

   

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

   

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

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

   

   La operación Salesforce Response:

   

Definir la operación 'Upsert de base de datos'

1. Arrastre una Actividad de lectura de variable de la paleta de componentes y suéltelo en una operación vacía en el tela de diseño.
2. Establezca el nombre de la operación en Database Upsert.
3. Haga doble clic en la actividad Leer.

4. En el paso 1, seleccione Sí, usar esquema guardado, haga clic en Esquemas guardados, seleccione Insertar esquema y luego haga clic en Siguiente.

   

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

   

6. Configurar una conexión a la base de datos para la base de datos de destino y haga clic en Guardar cambios. (En este ejemplo se muestra una conexión a un servidor PostgreSQL).

   

7. Arrastre una actividad Database Upsert de Database Upsert desde la paleta de componentes y suéltela sobre la operación Database Upsert, a la derecha de la actividad Read.

8. Haga doble clic en la actividad Upsert.

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

   

10. En el paso 2, seleccione las columnas que desea actualizar y haga clic en Siguiente.

    

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

    

12. En la operación Upsert de base de datos, agregue una nueva transformación entre las actividades Lectura y Upsert.

13. Mapeo manual los campos del objeto de origen de Salesforce a las columnas de la base de datos de destino y, luego, cierra la transformación para regresar al flujo de trabajo.

    

    La operación Upsert de base de datos:

    

Acciones de operación y despliegue

1. Abra la pantalla de configuración para la operación Mensaje saliente de Salesforce.
2. Seleccione la pestaña Acciones y luego configure los siguientes valores de campo:
   • Condición: En caso de éxito.
   • Acción: Ejecutar operación.
   • Operación: Respuesta de Salesforce.

3. Haga clic en + Agregar acción y luego cierre la pantalla de configuración de la operación.

   

4. Abra la pantalla de configuración para la operación Salesforce Response.

5. Seleccione la pestaña Acciones y luego configure los siguientes valores de campo:
   • Condición: En caso de éxito.
   • Acción: Ejecutar operación.
   • Operación: Upsert de base de datos.

6. Haga clic en + Agregar acción y luego cierre la pantalla de configuración de la operación.

   

   El proyecto completado, antes de la despliegue:

   

7. Desplegar el proyecto.

Parte 3: API de API Manager

1. En API Manager, seleccione APIs, luego haga clic en Nueva API.

2. En el paso 1 de la página Publicar nueva API, ingrese valores para lo siguiente y luego haga clic en Siguiente:

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

   • Ambiente: Seleccione el ambiente donde se implementó el proyecto de Integration Studio.

   • Raíz del servicio: Deje el valor inicial derivado del nombre de la API.

   • Número de versión: (opcional) Ingrese un número de versión de API.

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

   

3. En el paso 2, seleccione API personalizada como Tipo de servicio y haga clic en Agregar servicio API. Para el nuevo servicio API, introduzca estos valores en los siguientes campos, haga clic en Guardar y, a continuación, en Siguiente:

   • Método de solicitud: Use el menú para seleccionar el método de solicitud POST para el servicio API. Por defecto, el método de solicitud es GET.

   • Nombre del servicio: Ingrese un nombre de servicio.

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

     • Asignar proyecto: En el menú, seleccione su proyecto de Integration Studio.

     • Asignar operación(es):

       • Operación: Seleccione la operación Mensaje saliente de Salesforce.

       • Tipo de respuesta: Seleccione Objetivo final como tipo de respuesta.

   

4. En el paso 3, haz clic en Omitir este paso.

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

   

6. En el cuadro de diálogo titulado Todo listo, ¡su API está activa!, haga clic en Copiar URL y, luego, haga clic en Descartar.

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

1. En Salesforce, seleccione Configuración > Herramientas de la plataforma > Automatización de procesos > Acciones de Flujo de trabajo > Mensajes salientes.
2. En la página Mensajes salientes, haga clic en Editar para su mensaje saliente.

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

   

4. Seleccione Configuración > Herramientas de la plataforma > Automatización de procesos > Flujos.

5. Haga clic en la etiqueta del flujo correspondiente a la entrada Flujo de Jitterbit (resaltada en la imagen a continuación).

   

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

   

Probar la integración

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

1. En Salesforce, abra la aplicación Servicio y luego seleccione la pestaña Cuentas.
2. Edite un contacto de la cuenta y luego guárdelo.
3. Inicie sesión en su base de datos y consultar la tabla de destino.