Enviar Registros de Objetos de Salesforce Modificados a una Base de Datos Mediante la Regla de Flujo de Trabajo de Salesforce y el API Manager¶

Introducción¶

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

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

• Parte 1: En Salesforce, configure una regla de flujo de trabajo para enviar un mensaje saliente cuando cambie un objeto y descargue el archivo WSDL que define el mensaje.
• Parte 2: En Cloud 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 actualizar la URL del extremo del mensaje saliente, active el mensaje saliente y luego pruebe el patrón de diseño de integración completo.

Parte 1: Regla de Flujo de Trabajo de Salesforce y Archivo WSDL¶

1. En Salesforce, seleccione Configuración > Herramientas de plataforma > Automatización de procesos > Reglas de Flujo de Trabajo.

2. En la página Reglas de Flujo de Trabajo, haga clic en el botón Nueva regla (resaltado en la imagen a continuación). Si se abre un cuadro de diálogo Pruébelo en Flow Builder, haga clic en Continuar con las reglas de Flujo de Trabajo.

   

3. En la página Nueva regla de Flujo de Trabajo, haga clic en el menú Objeto, seleccione Cuenta y luego haga clic en Siguiente.

   

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

   • Nombre de la regla: Su elección de nombre.
   • Descripción: (Opcional) Una descripción para esta regla.
   • Criterios de evaluación: Creado y cada vez que se edita.
   • Criterios de regla: Haga clic en Ejecutar esta regla si y luego seleccione La fórmula se evalúa como verdadera.
   • En el campo de fórmula, ingrese verdadero.

   

5. En la página Editar regla, haga clic en Agregar acción de Flujo de Trabajo y luego seleccione Nuevo mensaje saliente (resaltado en la imagen a continuación).

   

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

   • Nombre: Tu elección de nombre.
   • Nombre único: Este nombre se genera automáticamente en función del valor de Nombre y las reglas de nomenclatura del campo.
   • Descripción: (Opcional) Una descripción para este mensaje saliente.
   • URL del Extremo: example.com. Esta URL temporal se actualiza más tarde.
   • Usuario para enviar como: 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 de objeto para 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.

   

7. En la página Editar regla, haga clic en Listo.

   

8. En la página Regla de Flujo de Trabajo, en la sección Acciones inmediatas de Flujo de Trabajo, haga clic en el enlace de descripción del mensaje saliente (resaltado en la imagen a continuación).

   

9. En la página Detalle del mensaje saliente del Flujo de Trabajo del mensaje, haga clic en el enlace Haga clic para WSDL en la fila etiquetada Extremo WSDL (resaltado en la imagen a continuación).

   

10. Se abre 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 deba configurar la extensión del archivo después de la descarga.

Parte 2: Operaciones de Cloud Studio¶

Definir la Operación 'Mensaje Saliente de Salesforce'¶

1. Cree un nuevo proyecto de Cloud 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 Examinar, seleccione el archivo WSDL descargado previamente 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 necesitan más modificaciones.

7. Haga clic en Siguiente.

   

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

   

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

10. Para el esquema de destino, haga clic en Reflejar esquema de origen.
11. Haga clic en Asignar automáticamente 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 la conexión y los nombres de las variables con sus valores predeterminados, luego haga clic en Guardar cambios.
16. Arrastre una Actividad de escritura variable desde 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 'Respuesta de Salesforce '¶

1. Arrastre una actividad de respuesta SOAP desde 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 Respuesta de Salesforce.
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 y luego cierre la transformación para volver al flujo de trabajo.

   

   La operación Respuesta de Salesforce:

   

Definir la Operación 'Inserción de Base de Datos'¶

1. Arrastre una Actividad de lectura variable desde 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. Configure una Conexión de base de datos para su base de datos de destino, luego haga clic en Guardar cambios. (En este ejemplo se muestra una conexión a un servidor PostgreSQL).

   

7. Arrastre una actividad Inserción de base de datos desde la paleta de componentes y suéltela en la operación Inserción de base de datos, a la derecha de la actividad Leer.

8. Haga doble clic en la actividad Upsert.

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

   

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

    

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

    

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

13. Mapa manual origine campos de objetos de Salesforce para apuntar a columnas de la base de datos y luego cierre la transformación para volver al flujo de trabajo.

    

    La operación Actualización de base de datos:

    

Acciones Operativas 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 establezca 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 operación.

   

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

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

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

   

   El proyecto completado, antes del despliegue:

   

7. Desplegar el proyecto.

Parte 3: API Manager de API¶

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

2. En el paso 1 de la página Publicar nueva API, ingrese los 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 Cloud 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 luego haga clic en Agregar servicio API. Para el nuevo servicio API, ingrese estos valores para los siguientes campos, haga clic en Guardar y luego haga clic en Siguiente:

   • Método de solicitud: Utilice el menú para seleccionar el método de solicitud POST para el servicio API. De forma predeterminada, el método de solicitud está configurado en 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 Cloud 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, haga clic en Omitir este paso.

5. En el paso 4, haga 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¶

1. En Salesforce, seleccione Configuración > Herramientas de 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. En la sección Reglas de Flujo de Trabajo que utilizan este mensaje saliente, haga clic en Activar para la regla (resaltada en la imagen a continuación).

   

Pruebe 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 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.