Consulta los conectores compatibles con Application Integration.

Para cada tarea en paralelo

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

Esta tarea usa el ID de activación de la API como identificador para determinar qué integraciones se deben ejecutar. Por ejemplo, si especifica el ID de activador de la API como api_trigger/APITriggerX, la tarea ejecuta todas las subintegraciones que tengan el ID de activador api_trigger/APITriggerX.

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

Antes de empezar

Configurar la tarea Para cada en paralelo

Para configurar la tarea Para cada paralelo, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

    Ir a Application Integration

  2. En el menú de navegación, haz clic en Integraciones.

    Aparecerá la página Integraciones, en la que se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

  3. Seleccione una integración o haga clic en Crear integración para crear una.

    Si vas a crear una integración:

    1. Escribe un nombre y una descripción en el panel Crear integración.
    2. Selecciona una región para la integración.
    3. Selecciona una cuenta de servicio para la integración. Puede 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 de la barra de herramientas de integración.
    4. Haz clic en Crear. La integración que acabas de crear se abre en el editor de integraciones.

  4. En la barra de navegación del editor de integraciones, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
  5. Haz clic en el elemento de tarea Para cada paralelo y colócalo en el editor de integración.
  6. Haga clic en el elemento de tarea Para cada paralelo del diseñador para abrir el panel de configuración de la tarea Para cada paralelo.
  7. Configure los campos que se muestran con las propiedades de configuración de la tarea, tal como se detalla en las tablas de abajo.

    Todos los cambios que hagas en las propiedades se guardarán automáticamente.

Propiedades de configuración

En esta sección se describen las propiedades de configuración de la tarea Por cada paralelo.

Propiedades de entrada

Nombre de la propiedad Nombre del parámetro Data type (Dato) Descripción
Selección de matriz List to iterate Una matriz de tipo cadena, entero, doble o JSON. Lista de valores para los que se deben ejecutar las subintegraciones. Se ejecuta un subproceso de integración independiente para cada valor de la lista y todos los subprocesos se ejecutan en paralelo.

Puedes transferir el valor iterado a la subintegración configurando el campo Dónde asignar elementos de la matriz.

También puede transferir valores adicionales de la integración principal a la secundaria en el campo Asignar a entradas de integración secundaria adicionales.

Detalles de la subintegración API Trigger ID Cadena ID del activador de la subintegración publicada que se va a ejecutar.

Este valor está disponible en el campo ID de activador del Activador de API de la subintegración.

Execution strategy N/A

SYNC ejecuta las subintegraciones en modo síncrono. En este modo, la integración principal espera a que se completen las subintegraciones antes de continuar con las tareas posteriores.

ASYNC ejecuta las subintegraciones en modo asíncrono. En este modo, la integración principal no espera a que se completen las secundarias. Inmediatamente después de llamar a las subintegraciones, la integración principal ejecuta las tareas posteriores.
Run all integrations with this API Trigger ID N/A Ejecuta todas las integraciones que tengan el mismo ID de activador de API.

Por ejemplo, si las integraciones A y B tienen el mismo ID de activador de la API, ambas integraciones (A y B) se ejecutan para cada elemento de Lista que iterar.

Nota: Si seleccionas esta opción, la respuesta de las subintegraciones no estará disponible en la integración principal. Si quieres usar la respuesta de las subintegraciones, selecciona la opción Ejecutar una sola integración.

Run a single integration N/A Solo ejecuta la integración especificada en el campo Nombre de la integración. Puedes usar la respuesta de las subintegraciones configurando la sección Recoger valores de las salidas de las subintegraciones.

En cada ejecución Where to map individual array elements Cadena Nombre de la variable de entrada de la subintegración en la que se deben asignar los elementos de la matriz. Los elementos del array se pueden asignar directamente a una variable de entrada de una subintegración. Si se selecciona una sola subintegración, puede seleccionar la variable de entrada de la subintegración en una lista desplegable.
Map to additional sub-integration input(s) Cadena Opción de asignación de subintegración adicional.
  • Variable de integración de la que se va a obtener el valor: el nombre de la variable de la integración actual que se va a transferir a la variable de entrada de la subintegración.
  • Entrada de la subintegración que se va a asignar: el nombre de la variable de entrada de la subintegración que se va a asignar.

Este campo acepta valores en forma de pares clave-valor, donde la clave es una variable de la integración principal y el valor es la variable de entrada correspondiente de la subintegración.

Por ejemplo, supongamos que tu integración principal tiene la variable productID, que quieres asignar a la variable de subintegración subIntProductID. Debes seleccionar productID en el campo Variable de integración de la que se va a obtener la asignación e introducir subIntProductID en el campo Entrada de subintegración a la que se va a asignar.

Collect values from sub-integration output(s) Cadena Si la estrategia de ejecución es síncrona (SYNC) y se selecciona una sola subintegración (Ejecutar una sola integración), las salidas de la subintegración se pueden recoger en variables de matriz de la integración actual.
  • Salida de la subintegración que se va a recoger: el nombre de la variable de salida de la subintegración que se va a agregar.
  • Variable de integración en la que se recopilarán los datos: el nombre de la variable de la integración actual en la que se recopilarán las salidas agregadas.
Ajustes de ejecución Integrations to execute at a time (parallel) Entero Número máximo de ejecuciones paralelas permitidas para las subintegraciones. El valor predeterminado es 50 (el máximo es 10000).

Todas las subintegraciones de una cohorte se ejecutan por completo antes de que se ejecute la siguiente cohorte de subintegraciones.

Ignore failures Booleano

Puedes especificar cualquiera de los siguientes valores:

  • True: la tarea ignora los errores de subintegración y ejecuta todas las ejecuciones.
  • False: la tarea falla debido a errores de subintegración y finaliza todas las ejecuciones.

Prácticas recomendadas

Te recomendamos que sigas estas prácticas recomendadas al usar la tarea For Each Parallel (Por cada paralelo):

  • Define el tamaño de la cohorte en función de las limitaciones de cuota que impongan tus subintegraciones.
  • Usa una estrategia de ejecución SYNC cuando quieras recoger el resultado de la subintegración para usarlo más adelante.
  • Usa una estrategia de ejecución ASYNC cuando tu subintegración pueda tardar más de 2 minutos.

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

Cuestiones importantes

Por lo general, no utilice una estrategia de ejecución SYNC si su subintegración tarda más de 2 minutos en ejecutarse o si tiene previsto usar esta tarea junto con tareas asíncronas, como la tarea de aprobación.

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