Consulta los conectores compatibles para Application Integration.

Tarea En parelelo

La tarea En paralelo te permite ejecutar otras integraciones (subintegraciones) desde tu integración principal. Como sugiere el nombre de la tarea, las integraciones secundarias se ejecutan en paralelo.

Esta tarea usa el ID del activador de la API como un controlador para identificar las integraciones que se ejecutarán. Por ejemplo, si especificas el ID del activador de la API como api_trigger/APITriggerX, la tarea ejecutará todas las subintegraciones que tengan el ID del activador api_trigger/APITriggerX.

Después de ejecutar una integración secundaria, también puedes leer la respuesta de la integración secundaria en tu integración principal. Usa esta tarea para ejecutar integraciones secundarias como dependencias de la integración principal.

Antes de comenzar

• Asegúrate de haber conectado una cuenta de servicio administrada por el usuario a tu integración. Si tu integración no tiene una cuenta de servicio administrada por el usuario configurada, se usa la cuenta de servicio predeterminada ([e-mail]) de forma predeterminada para la autenticación.
• Asegúrate de que tu cuenta de servicio tenga el rol de IAM Invocador de Application Integration. Para obtener información sobre cómo otorgar roles a una cuenta de servicio, consulta Administra el acceso a las cuentas de servicio.

Configura la tarea En paralelo

Para configurar la tarea En parelelo, haz lo siguiente:

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 con todas las integraciones disponibles en el proyecto de Google Cloud.

3. Selecciona una integración existente o haz clic en Crear integración para crear una nueva.

   Si creas una integración nueva, haz lo siguiente:

   1. Ingresa un nombre y una descripción en el panel Create Integration.
   2. 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.
   3. Selecciona una cuenta de servicio para la integración. Puedes cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración en la barra de herramientas de integración.
      Nota: La opción de seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de integraciones para la región seleccionada.
   4. Haz clic en Crear.

   Esto abrirá la integración en la página del editor de integración.

4. En la barra de navegación del editor de integración, haz clic en Tasks para ver la lista de tareas disponibles.
5. Haz clic y coloca el elemento de tarea Para cada tarea en paralelo en el editor de integración.
6. Haz clic en el elemento de tarea En parelelo en el diseñador para abrir el panel de configuración de la tarea En parelelo.
7. Configura los campos mostrados mediante las propiedades de configuración para la tarea, como se detalla en las tablas que aparecen a continuación.

   Los cambios en las propiedades se guardan de forma automática.

Propiedades de configuración

En esta sección, se describen las propiedades de configuración de la tarea For Each Parallel.

Propiedades de entrada

Nombre de la propiedad	Nombre del parámetro	Tipo de datos	Descripción
Selección de arrays	List to iterate	Un array de tipo cadena, número entero, doble o JSON.	Lista de valores para los que se deben ejecutar las integraciones secundarias. Se ejecuta un subproceso de integración secundaria por separado para cada valor de la lista, y todos los subprocesos se ejecutan en paralelo. Puedes pasar el valor de iteración a la integración secundaria si configuras el campo Dónde asignar elementos de array individuales. También puedes pasar valores adicionales de la integración principal a la integración secundaria en el campo Asignar a entradas de integraciones secundarias adicionales.
Detalles de la subintegración	API Trigger ID	String	ID del activador de la subintegración publicada que se ejecutará. Este valor está disponible en el campo ID del activador del activador de API en la integración secundaria.
	Execution strategy	No disponible	SYNC: Ejecuta la integración secundaria en modo síncrono. En este modo, la integración principal espera a que se completen las integraciones secundarias antes de continuar con las tareas descendentes. ASYNC: Ejecuta las integraciones secundarias en modo asíncrono. En este modo, la integración principal no espera a que se completen las integraciones secundarias. Inmediatamente después de llamar a las integraciones secundarias, la integración principal ejecuta las tareas descendentes.
	Run all integrations with this API Trigger ID	No disponible	Ejecuta todas las integraciones que tienen el mismo ID de activador de API. Por ejemplo, si la integración A y la integración B, tienen el mismo ID del activador de la API, se ejecutan las integraciones A y B para cada elemento de la lista que se debe iterar. Nota: Si seleccionas esta opción, la respuesta de las integraciones secundarias no está disponible en la integración principal. Si deseas usar la respuesta de las integraciones secundarias, selecciona la opción Run a single integration.
	Run a single integration	No disponible	Solo ejecuta la integración especificada en el campo Integration name. Puedes usar la respuesta de las integraciones secundarias mediante la configuración de la sección Recopila valores de las salidas de integraciones secundarias.
En cada ejecución	Where to map individual array elements	String	El nombre de la variable de entrada de la integración secundaria en la que se deben asignar los elementos del array. Los elementos del array se pueden asignar directamente a una variable de entrada de integración secundaria. Si seleccionas una única integración secundaria, puedes seleccionar la variable de entrada de la integración secundaria en una lista desplegable.
	Map to additional sub-integration input(s)	String	Opción de asignación de integración secundaria adicional. Integration variable to map from: El nombre de la variable en la integración actual que se pasará a la variable de entrada de la integración secundaria. Sub-integration input to map to: El nombre de la variable de entrada de la integración secundaria a la que se asignará. Este campo toma valores en forma de pares clave-valor, en los que la clave es una variable en la integración principal, y el valor es la variable de entrada correspondiente en la integración secundaria. Por ejemplo, considera que tu integración principal tiene la variable productID, que deseas asignar a la variable de subintegración subIntProductID. Debes seleccionar productID en el campo Variable de integración desde la que se asignará y, luego, ingresar subIntProductID en el campo Entrada de subintegración para asignar.
	Collect values from sub-integration output(s)	String	Si la estrategia de ejecución es síncrona (SYNC) y se selecciona una sola integración secundaria (Ejecutar una sola integración), los resultados de la integración secundaria se pueden recopilar en variables de array en la integración actual. Sub-integration output to collect from: Es el nombre de la variable de resultado de la integración secundaria que se agregará. Integration variable to collect into: Es el nombre de la variable en la integración actual para recopilar los resultados agregados.
Configuración de ejecución	Integrations to execute at a time (parallel)	Integer	Cantidad máxima de ejecuciones paralelas permitidas para las integraciones secundarias. El valor predeterminado es 50 (10000 como máximo). Todas las integraciones secundarias de una cohorte se ejecutan completamente antes de que se ejecute la siguiente cohorte de integraciones secundarias.
	Ignore failures	Booleano	Puedes especificar cualquiera de los siguientes valores: Verdadero: La tarea ignora las fallas de integración secundaria y ejecuta todas las ejecuciones. Falso: La tarea falla por errores de la integración secundaria y finaliza todas las ejecuciones.

prácticas recomendadas

Las siguientes son las prácticas recomendadas para usar la tarea For Each Parallel:

• Establece el tamaño de la cohorte en función de las limitaciones de cuota que imponen tus integraciones secundarias.
• Usa la estrategia de ejecución SYNC cuando quieras recopilar el resultado de la integración secundaria para usarla más tarde.
• Usa una estrategia de ejecución ASÍNCRONO cuando la integración secundaria podría ejecutarse más de 2 minutos.

Para obtener más información sobre los límites de uso que se aplican a la tarea Para cada paralelo, consulta Límites de uso.

Consideraciones

En general, no uses una estrategia de ejecución SYNC si la integración secundaria tarda más de 2 minutos en ejecutarse o planeas usar esta tarea junto con tareas asíncronas como la tarea de aprobación.

Estrategia de manejo de errores

Una estrategia de manejo de errores de una tarea específica la acción que se debe realizar si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de manejo de errores y conocer los diferentes tipos de estrategias de manejo de errores, consulta Estrategias de manejo de errores.