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 (
service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com) 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:
- En la IU de Apigee, selecciona tu organización de Apigee.
- Haz clic en Desarrollar > Integraciones.
- Elige una integración existente o crea una nueva haciendo clic en Crear integración.
Si creas una integración nueva, haz lo siguiente:
- Escribe un nombre y una descripción en el diálogo Crear integración.
- En la lista de regiones compatibles, elige Región para la integración.
- Haz clic en Crear.
Esto abrirá la integración en la página del diseñador de integración.
- En la barra de navegación Diseñador de integración, haz clic en +Agregar una tarea o un activador > Tareas para ver la lista de tareas disponibles.
- Haz clic y coloca el elemento de tarea Para cada tarea en paralelo en el editor de integración.
- 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.
- 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 del tipo string, 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 | El ID del activador de la integración secundaria 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
|
N/A |
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 |
N/A | Ejecuta todas las integraciones que tienen el mismo ID de activador de API.
Por ejemplo, si la integración 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 |
N/A | 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.
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 |
|
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.
| |
| 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 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:
|
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.