Consulta los conectores compatibles con Application Integration.

Para cada tarea de bucle

La tarea Para cada bucle te permite realizar llamadas repetidas a una integración secundaria desde tu integración actual (principal). La tarea se itera en la variable de array configurada y llama a la subintegración para cada elemento del array. La cantidad de veces que se llama a la subintegración es igual al tamaño de la variable del array.

El ID del activador de la API y el Nombre de la integración identifican la subintegración que deseas ejecutar.

La tarea también te permite recopilar la respuesta de cada ejecución de la subintegración y almacenar el valor en tu integración actual para su uso en tareas posteriores. Puedes usar cualquiera de los siguientes enfoques para recopilar las respuestas:

• Intercala la respuesta de cada ejecución en una variable de array, en la que cada elemento del arreglo tiene la respuesta de una ejecución en particular. Para recopilar las respuestas, configura la propiedad Collect values from sub-integration output(s).
• Agrega las respuestas de todas las ejecuciones en una sola variable. Para agregar las respuestas, configura la propiedad Response parameter override mapping.

Nota:

• La tarea Para cada bucle puede ejecutar un máximo de 8,000 iteraciones.
• El tamaño acumulativo de los datos recopilados de cada ejecución de la subintegración no puede exceder 50 MB. Si el tamaño supera 50 MB, la integración falla y las tareas descendentes no se ejecutan.
• Si falla una integración en la tarea Para cada bucle, falla la tarea completa y las tareas descendentes no se ejecutan. A fin de evitar errores en toda la integración, puedes especificar una estrategia de ejecución para la tarea en su panel de configuración de unión. Consulta Unirse para obtener más detalles.

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.

Propiedades de configuración

En la siguiente tabla, se describen las propiedades de configuración de la tarea Para cada bucle.

Propiedad	Tipo de datos	Descripción
API Trigger ID	String	El ID del activador de la integración secundaria que se ejecutará. Este valor está disponible en el campo ID del activador del activador de API en la integración secundaria.
Integration name	String	Nombre de la subintegración que se ejecutará.
List to iterate	Un array del tipo booleano, string, número entero, doble o JSON	Lista de valores para los que se deben ejecutar la subintegración. La subintegración se ejecuta para cada valor de la lista, uno después del otro. Puedes pasar el valor iterado a la subintegración si configuras la propiedad asignación de subintegración de elementos de iteración. En esta propiedad, especifica la variable en la subintegración a la que se debe asignar el valor iterado.
Iteration element sub-integration mapping	N/A	Variable en la subintegración para la que se debe asignar el elemento iterativo actual.
Map to additional sub-integration input(s)	N/A	Son valores adicionales que se pasarán de la integración actual a la subintegración. Los valores de esta propiedad tienen el formato de pares clave-valor, en los que la clave es una variable en la integración actual y el valor es la variable de entrada correspondiente en la subintegración. Por ejemplo, supongamos que tu integración principal tiene la variable productID, que deseas asignar a la variable de subintegración subIntProductID. Deberías seleccionar productID desde el menú desplegable Integration variable to map from y selecciona subIntProductID del menú desplegable Subintegration input to map to.
Collect values from sub-integration output(s)	N/A	Intercala los resultados de las ejecuciones de la subintegración. Cada vez que se ejecuta la subintegración, puedes almacenar su resultado en una variable de array de la integración actual. Selecciona la variable de salida de la subintegración desde el menú desplegable Sub-integration output to collect from y la variable de array en la integración actual desde el menú desplegable Integration variable to collect into. Cada elemento del array tiene la respuesta de una ejecución de subintegración en particular. Por ejemplo, si la variable de array es resultsArray, resultsArray[0] tiene la respuesta de la primera ejecución y resultsArray[1] tiene la respuesta de la segunda ejecución.
Response parameter override mapping	N/A	Lee la variable de salida de una ejecución de subintegración y almacénala en una variable de la integración actual. Selecciona la variable de resultado de la subintegración en el menú desplegable Sub-integration output to map from y selecciona la variable correspondiente en la integración actual del menú desplegable Integration variable to override. Puedes enviar la variable anulada en la integración actual a la siguiente ejecución de subintegración si asignas la variable en la propiedad Map to additional sub-integration input(s). Como resultado, puedes agregar las respuestas de las ejecuciones de subintegración de forma acumulativa.
Loop metadata	Arreglo JSON	La variable de resultado que tiene los detalles de ejecución de las subintegraciones, como el ID de ejecución de la subintegración, los mensajes de error y los valores de las variables que se pasaron durante la ejecución. Los metadatos del bucle contienen variables, incluidas las siguientes variables de salida: current_iteration_count, sub_integration_execution_ids, failure_location, current_element, iteration_element y failure_message. Advertencia: En los metadatos de Loop, encontrarás claves duplicadas para la variable de salida, por ejemplo, Current Iteration Count y current_iteration_count. Te recomendamos usar las variables que contienen el símbolo de guion bajo (_), ya que las otras claves dejarán de estar disponibles.

Prácticas recomendadas

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

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.

Cuotas y límites

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

¿Qué sigue?

• Obtén información sobre todas las tareas y los activadores.
• Obtén información para probar y publicar una integración.
• Obtén más información sobre el manejo de errores.
• Obtén más información sobre los registros de ejecución de la integración.