Consulta los conectores compatibles para la integración de aplicaciones.

Cómo invocar una integración secundaria con una tarea de Bucle para cada elemento

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

Crea 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 Integraciones.
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 para ver la lista de los 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) en la barra de navegación de diseñador para abrir el panel Variables.
2. Haz clic en +Crear para crear una variable.

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

   a. Nombre: Ingresa order_details.

   b. Data Type (Tipo de datos): Selecciona JSON.

   c. Haz clic en Inferir a partir del 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 deseas usar para probar la integración.

   e. Haz clic en Usar como entrada para la integración.

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

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

1. En el editor de integración, haz clic en Tareas 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 Data Mapping 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 la Entrada 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. Agrega una función de asignación a obj1. Haz clic en el signo + en CADA fila entre paréntesis después del elemento obj1 que acabas de agregar. En la lista de funciones, desplázate hacia abajo y selecciona GET PROPERTY(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 GET PROPERTY y selecciona TO_STRING() -> Cadena.
   11. Haz clic en + Agregar una función en la última fila y selecciona TO_STRING() -> Cadena.
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 de 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 envío de correo electrónico

Para agregar y configurar la tarea Enviar correo electrónico y 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 Tareas y haz clic en el elemento Enviar correo electrónico para colocarlo en el editor de integración.
3. Haz clic en el elemento de tarea Send Email en el editor de integración para abrir el panel de configuración de la tarea.

4. Configura los siguientes campos de Task Input:

   1. Para 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 del elemento activador de la API al elemento Asignación de datos. Coloca el cursor sobre un punto de control del elemento Activador de API, luego haz clic y arrastra una línea hasta un punto de control en el elemento Asignación de datos.
2. De manera similar, agrega una arista del elemento de 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 Probar en la barra de herramientas del editor de integraciones y, luego, en Probar integración 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 especificada en la tarea Enviar correo electrónico. 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 integraciones.

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 a través del bucle For Each. Puedes crear esta variable ahora o en el siguiente paso cuando agregues y configures la tarea For Each Loop. Para esta guía de inicio rápido, crea la variable ahora.

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

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

   a. Nombre: Ingresa order_requests.

   b. Data Type (Tipo de datos): Selecciona JSON.

   c. Haz clic en Inferir a partir del 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 por el ID de correo electrónico que deseas usar para probar la integración.

   e. Haz clic en Usar como entrada para la integración.

   f. Haz clic en Crear.

Agrega y configura una tarea Para cada bucle

1. En el editor de integración, haz clic en Tasks.
2. Haz clic y coloca el elemento Para cada bucle en el editor de integración.
3. Haz clic en el elemento de tarea Para cada bucle en el editor de integración para abrir el panel de configuración de la tarea.
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 del activador de la API: Selecciona el activador de la 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 quieres invocar. Para 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 del elemento activador de la API al elemento For Every Loop. Coloca el cursor sobre un punto de control del elemento Activador de API y, luego, haz clic en una línea y arrástrala hasta un punto de control del 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 Probar en la barra de herramientas del editor de integración y, luego, en Probar integración en el diálogo Test Integration. Cuando se complete la prueba, deberías ver un mensaje de éxito.

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.

Cuotas y límites

Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.