Consulta los conectores compatibles con Application Integration.
En cada tarea en bucle
La tarea En cada bucle te permite hacer llamadas repetidas a una subintegración desde tu integración principal. La tarea itera sobre la variable de matriz configurada y llama a la subintegración para cada elemento de la matriz. El número de veces que se llama a la subintegración es igual al tamaño de la variable de matriz.
El ID de activación de la API y el nombre de la integración identifican la subintegración que quieres ejecutar.
La tarea también te permite recoger la respuesta de cada ejecución de subintegración y almacenar el valor en tu integración actual para usarlo en tareas posteriores. Puedes usar cualquiera de los siguientes métodos para recoger las respuestas:
- Recopila la respuesta de cada ejecución en una variable de matriz, donde cada elemento de la matriz tiene la respuesta de una ejecución concreta. 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.
Antes de empezar
- Asegúrate de haber vinculado una cuenta de servicio gestionada por el usuario a tu integración. Si tu integración no tiene configurada una cuenta de servicio gestionada por el usuario, se usará de forma predeterminada la cuenta de servicio predeterminada (
service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) para la autenticación. - Asegúrate de que tu cuenta de servicio tenga el rol de gestión de identidades y accesos Invocador de integración de aplicaciones. Para obtener información sobre cómo conceder roles a una cuenta de servicio, consulta el artículo sobre cómo gestionar el acceso a cuentas de servicio.
Propiedades de configuración
En la siguiente tabla se describen las propiedades de configuración de la tarea Bucle For Each.
| Propiedad | Data type (Dato) | Descripción |
API Trigger ID
|
Cadena | ID de activación de la subintegración que se va a ejecutar.
Este valor está disponible en el campo ID de activador del Activador de API de la subintegración. |
Integration name |
Cadena | Nombre de la subintegración que se va a ejecutar. |
List to iterate
|
Una matriz de tipo booleano, cadena, entero, doble o JSON. | Lista de valores para los que se debe ejecutar la subintegración. La subintegración se ejecuta para cada valor de la lista, uno después del otro.
Para pasar el valor iterado a la subintegración, define la propiedad Mapeo de subintegración de elemento de iteración. En esta propiedad, especifique la variable de la subintegración a la que se debe asignar el valor iterado. |
Iteration element sub-integration mapping |
N/A | Variable de la subintegración a la que se debe asignar el elemento iterado actual. |
Map to additional sub-integration input(s)
|
N/A | Valores adicionales que se deben transferir de la integración actual a la subintegración.
Los valores de esta propiedad tienen la forma de pares clave-valor, donde la clave es una variable de la integración actual y el valor es la variable de entrada correspondiente de la subintegración. Por ejemplo, supongamos que tu integración principal tiene la variable |
Collect values from sub-integration output(s)
|
N/A | Recopila los resultados de las ejecuciones de la subintegración.
Cada vez que se ejecute la subintegración,
puedes almacenar su salida en una variable de matriz de la integración actual.
Seleccione la variable de salida de la subintegración en el menú desplegable Variable de salida de la subintegración que se va a recoger y la variable de matriz de la integración actual en el menú desplegable Variable de integración en la que se va a recoger. Cada elemento de la matriz tiene la respuesta de una ejecución de subintegración concreta. Por ejemplo, si la variable de matriz es |
Response parameter override mapping
|
N/A | Lee la variable de salida de una ejecución de una subintegración y guárdala en una variable de la integración actual.
Seleccione la variable de salida de la subintegración en el menú desplegable Variable de salida de la subintegración que se va a asignar y, a continuación, seleccione la variable correspondiente de la integración actual en el menú desplegable Variable de integración que se va a sustituir. Puedes enviar la variable sustituida en la integración actual a la siguiente subintegración asignando la variable en la propiedad Asignar a subintegraciones adicionales. Por lo tanto, puedes agregar de forma acumulativa las respuestas de las ejecuciones de la subintegración. |
Loop metadata |
Matriz JSON | Variable de salida que contiene 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 transferidos durante la ejecución. Los metadatos de 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.
|
Prácticas recomendadas
Para obtener información sobre los límites de uso que se aplican a la tarea En cada bucle, consulta Límites de uso.
Estrategia de gestión de errores
Una estrategia de gestión de errores de una tarea especifica la acción que se debe llevar a cabo si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de gestión de errores y conocer los diferentes tipos de estrategias de gestión de errores, consulta Estrategias de gestión de errores.
Cuotas y límites
Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.
Siguientes pasos
- Consulta información sobre todas las tareas y los activadores.
- Consulta cómo probar y publicar una integración.
- Consulta información sobre el tratamiento de errores.
- Consulta información sobre los registros de ejecución de integraciones.