Consulta los conectores compatibles para Application Integration.

Invocar una subintegración con una tarea For cada bucle

En esta guía de inicio rápido, se muestra cómo crear una integración que use una tarea de bucle para cada bucle a fin de invocar una subintegración. La subintegración toma la entrada de la integración principal y envía correos electrónicos a los destinatarios mediante la tarea Enviar correo electrónico.

Cómo crear la subintegración

1. En la consola de Google Cloud, ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Integraciones. Aparecerá la página Integrations List.
3. Haz clic en Crear integración.
4. Ingresa un nombre y una descripción para la integración.

   Para esta guía de inicio rápido, ingresa el nombre ForEachSendEmailSubIntegration y la descripción Quickstart sub-integration.

5. Selecciona una región para la integración.
   Nota: En el menú desplegable Regiones, solo se enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
6. Haz clic en Crear para abrir el editor de integración.

Agrega un activador de API en la subintegración

Se requieren activadores para iniciar la secuencia de tareas que conforman una integración. En esta guía de inicio rápido, usarás un activador de API para iniciar la integración.

Para agregar y configurar el activador de la API, sigue estos pasos:

1. En el editor de integración, haz clic en Activadores (Triggers) para ver la lista de activadores disponibles.
2. Haz clic y coloca el elemento activador de API en el editor de integración.

Crea una variable de entrada en la subintegración

La subintegración usa una variable para almacenar los detalles recibidos en formato JSON de la integración principal. Para crear una nueva variable de entrada, sigue estos pasos:

1. Haz clic en (Activar o desactivar panel) en la barra de navegación del diseñador para abrir el panel Variables.
2. Haz clic en +Crear para generar una variable.

3. En el panel Crear variable, haz lo siguiente:

   a. Nombre: Ingresa order_details.

   b. Tipo de datos: Selecciona JSON.

   c. Haz clic en Inferir desde el valor predeterminado.

   d. En Valor predeterminado, ingresa el siguiente JSON.

     {
       "orderId": "1",
       "customerName": "Harry Ford",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "New York",
         "country": "USA",
         "zipcode": "103487"
         },
       "items": [{
         "itemid": "111-222-333",
         "itemName": "Smartphone",
         "itemPrice": 999.0,
         "quantity": 1.0
         }, {
         "itemid": "444-555-666",
         "itemName": "Mobile Cover",
         "itemPrice": 49.0,
         "quantity": ""
         }],
       "paymentDetails": {
         "mode": "COD",
         "status": ""
         },
       "expectedDelivery": "15 March 2023"
     }
   

   En este objeto JSON de muestra, reemplaza YOUR_EMAIL_ID por el ID de correo electrónico que quieres usar para probar la integración.

   e. Haz clic en Use as an input to integration.

   f. Haz clic en Crear.

Agrega y configura una tarea de asignación de datos

La tarea de asignación de datos te permite realizar asignaciones de variables en tu integración, obtener y establecer propiedades de objetos JSON, y aplicar funciones de transformación anidadas a valores. Las variables que usa la tarea de asignación de datos pueden ser variables de integración o de tarea.

Para agregar y configurar una tarea de asignación de datos, sigue estos pasos:

1. En el editor de integración, haz clic en Tasks para ver la lista de tareas disponibles.
2. Haz clic y coloca el elemento Asignación de datos en el editor de integración.
3. Haz clic en el elemento Asignación de datos en el editor de integración para abrir el panel de configuración de tareas.
4. Haz clic en Abrir editor de asignación de datos.
5. Configura el objeto Input de la siguiente manera:
   1. En la sección Entrada, haz clic en Variable o valor.
   2. En Variable, ingresa item y, luego, selecciona order_details.items.
   3. Haz clic en Guardar.
   4. Agrega una función de asignación a order_details.items. Haz clic en el símbolo + junto a order_details.items. En la lista de funciones, desplázate hacia abajo y selecciona FOR_EACH(Any) -> JSON.
   5. Ingresa el parámetro de entrada de la función FOR_EACH. Haz clic en Variable o Valor y selecciona ~obj1.
   6. Haz clic en Guardar.
   7. Agregar una función de asignación a obj1. Haz clic en + en la fila PARA CADA UNIDAD dentro del paréntesis después del elemento obj1 que acabas de agregar. En la lista de funciones, desplázate hacia abajo y selecciona OBTENER PROPIEDAD(String) -> JSON.
   8. Haz clic en Variable o valor y, en Valor, ingresa itemName.
   9. Haz clic en Guardar.
   10. Haz clic en + Agregar una función en la fila después de OBTENER PROPIEDAD y selecciona TO_STRING() -> String.
   11. Haz clic en + Agregar una función en la última fila y selecciona TO_STRING() -> String.
6. Configura la Salida de la siguiente manera:
   1. Crea una nueva variable de salida. En la sección Resultado, haz clic en crear uno nuevo.
   2. En el panel Crear variable, ingresa el nombre items, conserva los valores predeterminados de todos los otros campos y haz clic en Crear.
7. Verifica que la configuración de la asignación de datos sea similar a la que se muestra en la siguiente imagen.

   

8. Cierra el Editor de asignación de datos para volver al editor de integración.

Agrega y configura una tarea de Enviar correo electrónico

Si quieres agregar y configurar la tarea Enviar correo electrónico para enviar un correo electrónico a cada uno de los destinatarios, sigue estos pasos.

1. En el editor de integración, haz clic en Agregar una tarea o un activador.
2. Ve a Tasks y haz clic en el elemento Send Email y colócalo en el editor de integración.
3. Haz clic en el elemento de la tarea Enviar correo electrónico en el editor de integración para abrir el panel de configuración de tareas.

4. Configura los siguientes campos de Entrada de tarea:

   1. Para los destinatarios: Haz clic en Variable y selecciona order_details.emailId.
   2. Asunto: Ingresa el asunto del correo electrónico. Para esta guía de inicio rápido, ingresa Order delivery notification.
   3. Cuerpo en texto sin formato: Ingresa el siguiente texto:

   Hi $order_details.customerName$! Your order with Order Id: $order_details.orderId$ with items: $items$ has been successfully placed. Expected delivery by: $order_details.expectedDelivery$.
   

Conecta los elementos de la subintegración

Ahora que agregaste y configuraste las tareas y los activadores necesarios en la subintegración, agrega una conexión (perímetro) entre los elementos. Un borde denota el flujo de control de un elemento al siguiente.

1. Agrega una arista desde el elemento Activador de API al elemento Asignación de datos. Coloca el cursor sobre un punto de control en el elemento Activador de la API y, luego, haz clic en una línea y arrástrala hasta un punto de control en el elemento Asignación de datos.
2. De manera similar, agrega una arista desde el elemento Asignación de datos al elemento Enviar correo electrónico.

Prueba y publica la subintegración

1. Para probar esta subintegración, haz clic en Test en la barra de herramientas del editor de integración y, luego, en Test integration, en el diálogo Test Integration. La subintegración se ejecuta con el valor predeterminado como entrada y envía un correo electrónico a la dirección de correo electrónico especificada en la tarea Send Email. Deberías ver un mensaje de éxito cuando se complete la prueba.
2. Para publicar esta subintegración, haz clic en Publicar en la barra de herramientas del editor de integración.

Crea la integración principal

1. En el menú de navegación, haz clic en Integraciones para volver a la página Integraciones.
2. Haz clic en Crear integración.
3. Ingresa un nombre y, de manera opcional, una descripción para la integración. Para esta guía de inicio rápido, ingresa el nombre ForEachSendEmail y la descripción Quickstart main integration.
4. En la lista de regiones compatibles, selecciona Región para la integración. Asegúrate de crear la integración principal en la misma región que la subintegración.
5. Haz clic en Crear.

Agrega un activador de API en la integración principal

1. En el editor de integración, haz clic en Activadores para ver la lista de tareas y activadores disponibles.
2. Haz clic y coloca el elemento activador de API en el editor de integración.

Crea una variable de entrada en la integración principal

En la integración principal, se usa una variable de entrada para almacenar los datos que se pasan a la subintegración con el bucle "Para cada uno". Puedes crear esta variable ahora o en el siguiente paso, cuando agregues y configures la tarea For cada bucle. Para esta guía de inicio rápido, crea la variable ahora.

1. Haz clic en (Activar o desactivar panel) en la barra de navegación del diseñador para abrir el panel Variables.

2. En el panel Crear variable, haz lo siguiente:

   a. Nombre: Ingresa order_requests.

   b. Tipo de datos: Selecciona JSON.

   c. Haz clic en Inferir desde el valor predeterminado.

   d. En Valor predeterminado, ingresa el siguiente JSON:

     [{
       "orderId": "1",
       "customerName": "Harry Ford",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "New York",
         "country": "USA",
         "zipcode": "103487"
       },
       "items": [{
         "itemid": "111-222-333",
         "itemName": "Smartphone",
         "itemPrice": 999.0,
         "quantity": 1.0
       }, {
         "itemid": "444-555-666",
         "itemName": "Mobile Cover",
         "itemPrice": 49.0,
         "quantity": ""
       }],
       "paymentDetails": {
         "mode": "COD",
         "status": ""
       },
      "expectedDelivery": "15 March 2023"
     }, {
       "orderId": "2",
       "customerName": "Tim Harvey",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "Los Angeles",
         "country": "USA",
         "zipcode": "210738"
       },
       "items": [{
         "itemid": "222-333-444",
         "itemName": "Laptop",
         "itemPrice": 5999.0,
         "quantity": 1.0
      }],
       "paymentDetails": {
         "mode": "Online Payment",
         "status": "Success"
       },
       "expectedDelivery": "21 Feb 2023"
     }]
   

   En este objeto JSON de muestra, reemplaza ambos casos de YOUR_EMAIL_ID con el ID de correo electrónico que deseas usar para probar la integración.

   e. Haz clic en Use as an input to integration.

   f. Haz clic en Crear.

Cómo agregar y configurar una tarea Para cada bucle

1. En el editor de integración, haz clic en Tasks.
2. Haz clic y coloca el elemento For Every Loop en el editor de integración.
3. Haz clic en el elemento de tareas Para cada bucle en el editor de integración para abrir el panel de configuración de tareas.
4. En el panel de configuración, haz lo siguiente:
   1. Lista para iterar: Selecciona la variable de entrada que creaste, order_requests.
   2. ID de activador de API: Selecciona el activador de API en tu subintegración. Para esta guía de inicio rápido, selecciona api_trigger/ForEachSendEmailSubIntegration_API_1.
   3. Nombre de la integración: Selecciona el nombre de la subintegración que deseas invocar. En esta guía de inicio rápido, selecciona ForEachSendEmailSubIntegration.
   4. Asignación de subintegración de elementos de iteración: Selecciona order_details.

Conecta los elementos en la integración principal

1. Agrega una arista desde el elemento Activador de la API al elemento Para cada bucle. Coloca el cursor sobre un punto de control en el elemento Activador de la API y, luego, haz clic en una línea y arrástrala hasta un punto de control en el elemento Para cada bucle.

Prueba y publica la integración principal

La tarea final es probar y publicar la integración principal.

1. Haz clic en Test en la barra de herramientas del editor de integración y, luego, haz clic en Test integration en el diálogo Test Integration. Deberías ver un mensaje de éxito cuando se complete la prueba.

2. Para publicar esta integración, haz clic en Publicar en la barra de herramientas del editor de integración.

   Cuando se completa de forma correcta, la integración envía un correo electrónico a la dirección especificada en la tarea Enviar correo electrónico. Confirma la recepción del correo electrónico en tu cliente de correo electrónico.