Consulta los conectores compatibles con Application Integration.
Tarea de integración de llamadas
La tarea Integración de llamadas te permite invocar o llamar a otras integraciones creadas en tu proyecto de Google Cloud.
La tarea Integración de llamadas es útil en situaciones en las que necesitas definir varias integraciones pequeñas (subintegraciones) que se controlan mediante una integración principal (integración superior). Después de ejecutar una subintegración, también puedes leer la respuesta de la subintegración en tu integración principal.
Antes de empezar
- La tarea Integración de llamadas usa el activador de API para identificar y llamar a otras integraciones y subintegraciones. Por lo tanto, debes asegurarte de que las integraciones a las que quieras llamar estén configuradas con el activador de API. Para obtener información sobre cómo configurar un activador de API, consulta Activador de API.
- 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.
Configurar la tarea de integración de llamadas
Para configurar la tarea Integración de llamadas, sigue estos pasos:
- En la Google Cloud consola, ve a la página Integración de aplicaciones.
- 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.
- Seleccione una integración o haga clic en Crear integración para crear una.
Si vas a crear una integración:
- Escribe un nombre y una descripción en el panel Crear integración.
- Selecciona una región para la integración.
- 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.
- Haz clic en Crear. La integración que acabas de crear se abre en el editor de integraciones.
- En la barra de navegación del editor de integraciones, haz clic en Tareas para ver la lista de tareas y conectores disponibles.
- Haz clic en el elemento Integración de llamadas y colócalo en el editor de integraciones.
- Haz clic en el elemento de tarea Integración de llamadas del diseñador para ver el panel de configuración de la tarea Integración de llamadas.
- Configura los siguientes detalles de la subintegración:
- ID de activador de API: escribe el ID de activador de API de la integración a la que quieras llamar. Puede llamar a una o varias integraciones con el mismo ID de activador.
- Ejecutar todas las integraciones con este ID de activador de API: selecciona esta opción para llamar a todas las integraciones que tengan el mismo ID de activador de API.
Por ejemplo, si las integraciones
A
yB
tienen el mismo ID de activador de API, se ejecutan ambas.A
B
- Ejecutar una sola integración: selecciona esta opción para llamar solo a la integración especificada en el campo Nombre de la integración. Puedes acceder a la respuesta de la subintegración y asignarla
configurando los campos que se detallan en Asignar variables de respuesta de subintegración.
- Estrategia de ejecución: selecciona los modos de ejecución de las subintegraciones a las que quieras llamar.
- SYNC ejecuta la subintegración 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 la subintegración 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 integraciones secundarias, la integración principal ejecuta las tareas posteriores.
Si esta opción está seleccionada, defina el Retraso de ejecución (en milisegundos). Si se define, especifica el retraso hasta que se ejecute la integración.
Todos los cambios que hagas en las propiedades se guardarán automáticamente.
Variables de respuesta de la subintegración de mapas
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 subintegración. 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, si quiere asignar la variable |
Map values to sub-integration output(s)
|
Asigna las variables de salida de la subintegración a las variables de la integración principal.
Haga clic en Salida de subintegración para asignar y seleccione la subintegración. Haga clic en Variable de integración que se va a asignar y seleccione la variable de integración principal correspondiente. |
Prácticas recomendadas
Para obtener información sobre los límites de uso que se aplican a la tarea Integración de llamadas, 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.