Consulta los conectores compatibles con Application Integration.

Tarea Integración de llamadas

La tarea Integración de llamadas te permite invocar o llamar a otras integraciones creadas dentro de tu proyecto de Google Cloud.

La tarea Integración de llamadas es útil en situaciones en las que necesitas definir varias integraciones pequeñas (integraciones secundarias) que se controlan mediante una integración principal (integración superior). Después de ejecutar una integración secundaria, también puedes leer la respuesta de la integración secundaria en tu integración principal.

Antes de comenzar

• La tarea Integración de llamadas usa el activador de APIs para identificar y llamar a otras integraciones y subintegraciones. Por lo tanto, debes asegurarte de que las integraciones a las que deseas llamar estén configuradas mediante el activador de APIs. Para obtener información sobre cómo configurar un activador de API, consulta Activador de API.
• 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 Integración de llamadas

Para configurar la tarea Integración de llamadas, 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, en la que se enumerarán 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 la integración.
      Nota: La opción para seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de integración 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 y conectores disponibles.
5. Haz clic en el elemento Integración de llamadas y colócalo en el editor de integración.
6. Haz clic en el elemento de tarea Call Integration en el diseñador para ver el panel de configuración de la tarea Call Integration.
7. Configura los siguientes detalles de subintegración:
   1. ID del activador de API: Escribe el ID del activador de la API de la integración a la que deseas llamar. Puedes llamar a una sola integración o a varias integraciones con el mismo ID de activador.
   2. Ejecutar todas las integraciones en este ID de activador de API: Selecciona esta opción para llamar a 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.

      Nota: Si seleccionas esta opción, la respuesta de las integraciones secundarias no estará disponible en la integración principal. Si deseas acceder a la respuesta de las integraciones secundarias, selecciona la opción Run a single integration.
   3. Run a single integration: selecciona esta opción para llamar solo a la integración especificada en el campo Integration name. Puedes acceder y asignar la respuesta de la integración secundaria mediante la configuración de los campos detallados en Mapea las variables de respuesta de integración secundaria.

   4. Estrategia de ejecución: Selecciona los modos de ejecución para las integraciones secundarias a las que deseas llamar.
      • 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 la integración secundaria 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.

        Si se selecciona esta opción, configura el Retraso de ejecución (en milisegundos). Cuando se establece, esto especifica el retraso de tiempo hasta que se ejecuta la integración.

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

Asigna variables de respuesta de integración secundaria

En la siguiente tabla, se describen las propiedades de configuración para asignar variables entre la integración principal y las secundarias:

Propiedad	Descripción
Map to sub-integration input(s)	Asigna valores de la integración principal a la integración secundaria. 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, si deseas asignar la variable productID de la integración principal a la variable de integración secundaria subIntProductID, selecciona productID en el campo Integration variable to map from y, luego, ingresa subIntProductID en el campo Subintegration input to map to.
Map values to sub-integration output(s)	Asigna las variables de salida de integración secundaria a las variables de integración principal. Haz clic en Subintegration output to map from y selecciona la integración secundaria. Haz clic en Variable de integración para asignar y selecciona la variable de integración principal correspondiente. Nota: Este campo solo se muestra cuando se selecciona la opción Ejecutar una sola integración con la estrategia de ejecución SYNC.

Prácticas recomendadas

Para obtener más información sobre los límites de uso que se aplican a la tarea Llamar a la integración, 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 información sobre la manejo de errores.
• Obtén información sobre los registros de ejecución de integración.