La tâche Appeler une intégration vous permet d'appeler d'autres intégrations créées dans votre projet Google Cloud.
La tâche Appeler une intégration est utile lorsque vous devez définir plusieurs petites intégrations (sous-intégrations) contrôlées à l'aide d'une intégration principale (intégration parente). Après avoir exécuté une sous-intégration, vous pouvez également lire la réponse de la sous-intégration dans votre intégration principale.
Avant de commencer
La tâche Appeler une intégration utilise le déclencheur d'API pour identifier et appeler d'autres intégrations et sous-intégrations. Par conséquent, vous devez vous assurer que les intégrations que vous souhaitez appeler sont configurées à l'aide du déclencheur d'API. Pour en savoir plus sur la configuration d'un déclencheur d'API, consultez la page Déclencheur d'API.
Assurez-vous d'avoir associé un compte de service géré par l'utilisateur à votre intégration. Si aucun compte de service géré par l'utilisateur n'est configuré pour l'intégration, le compte de service par défaut (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) est utilisé par défaut pour l'authentification.
Assurez-vous que votre compte de service dispose du rôle IAM Demandeur Application Integration. Pour en savoir plus sur l'attribution d'un rôle à un compte de service, consultez la page Gérer l'accès aux comptes de service.
Configurer la tâche Appeler une intégration
Pour configurer la tâche Appeler une intégration :
Dans la console Google Cloud , accédez à la page Application Integration (Intégration d'applications).
Dans le menu de navigation, cliquez sur Intégrations.
La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud.
Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.
Si vous créez une intégration :
Saisissez un nom et une description dans le volet Créer une intégration.
Sélectionnez une région pour l'intégration.
Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment dans le volet infoRécapitulatif de l'intégration de la barre d'outils d'intégration.
Cliquez sur Créer. L'intégration nouvellement créée s'ouvre dans l'éditeur d'intégration.
Dans la barre de navigation de l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches et des connecteurs disponibles.
Cliquez sur l'élément Call Integration et placez-le dans l'éditeur d'intégration.
Cliquez sur l'élément de tâche Appel d'intégration de l'éditeur pour ouvrir le volet de configuration de la tâche Appel d'intégration.
Configurez les détails de la sous-intégration suivants :
ID de déclencheur d'API : saisissez l'ID de déclencheur d'API de l'intégration que vous souhaitez appeler. Vous pouvez appeler une seule intégration ou plusieurs intégrations avec le même ID de déclencheur.
Exécuter toutes les intégrations avec cet ID de déclencheur de l'API : sélectionnez cette option pour appeler toutes les intégrations ayant le même ID de déclencheur d'API.
Par exemple, si l'intégration A et l'intégration B ont le même ID de déclencheur d'API, les intégrations A et B sont exécutées.
Exécuter une seule intégration : sélectionnez cette option pour appeler uniquement l'intégration spécifiée dans le champ Nom de l'intégration. Vous pouvez accéder aux réponses de la sous-intégration et les mapper en configurant les champs détaillés dans la section Mapper les variables de réponse de sous-intégration.
Stratégie d'exécution : sélectionnez les modes d'exécution pour les sous-intégrations que vous souhaitez appeler.
SYNC : exécute la sous-intégration en mode synchrone. Dans ce mode, l'intégration principale attend que les sous-intégrations soient terminées avant de poursuivre les tâches en aval.
ASYNC : exécute la sous-intégration en mode asynchrone. Dans ce mode, l'intégration principale n'attend pas que les sous-intégrations soient terminées. Immédiatement après l'appel des sous-intégrations, l'intégration principale exécute les tâches en aval.
Si cette option est sélectionnée, définissez le délai avant exécution (en millisecondes). Lorsque ce champ est défini, il spécifie le délai avant exécution de l'intégration.
Les modifications que vous avez apportées aux propriétés sont enregistrées automatiquement.
Mapper les variables de réponse de sous-intégration
Le tableau suivant décrit les propriétés de configuration permettant de mapper les variables entre l'intégration principale et les sous-intégrations :
Propriété
Description
Map to sub-integration input(s)
Mappe les valeurs de l'intégration principale sur la sous-intégration. Ce champ prend des valeurs sous la forme de paires clé/valeurs, où la clé est une variable dans l'intégration principale, et la valeur est la variable d'entrée correspondante dans la sous-intégration.
Par exemple, si vous souhaitez mapper la variable productID de l'intégration principale sur la variable de sous-intégration subIntProductID, sélectionnez productID dans la variable d'intégration à mapper, puis saisissez subIntProductID dans le champ Entrée de sous-intégration vers laquelle mapper.
Map values to sub-integration output(s)
Cela vous permet de mapper les variables de sortie de sous-intégration avec les variables d'intégration principale.
Cliquez sur Sortie de sous-intégration à mapper, puis sélectionnez la sous-intégration. Cliquez sur Variable d'intégration vers laquelle mapper, puis sélectionnez la variable d'intégration principale correspondante.
Bonnes pratiques
Pour en savoir plus sur les limites d'utilisation qui s'appliquent à la tâche Appel d'intégration, consultez la section Limites d'utilisation.
Stratégie de traitement des erreurs
Une stratégie de traitement des erreurs d'une tâche spécifie l'action à effectuer si celle-ci échoue en raison d'une erreur temporaire. Pour en savoir plus sur l'utilisation et les différents types de stratégies de traitement des erreurs, consultez la page Stratégies de traitement des erreurs.
Quotas et limites
Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/03 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/03 (UTC)."],[[["\u003cp\u003eThe Call Integration task allows you to invoke other integrations within your Google Cloud project, enabling the creation of sub-integrations controlled by a parent integration.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Call Integration task, the integrations you intend to call must be configured with an API trigger, and the service account should have the Application Integration Invoker IAM role.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure the Call Integration task to run multiple integrations with the same API Trigger ID or run a single specific integration and map the response variables accordingly.\u003c/p\u003e\n"],["\u003cp\u003eThe Call Integration task supports synchronous (SYNC) and asynchronous (ASYNC) execution strategies for sub-integrations, allowing control over how the main integration interacts with the sub-integrations.\u003c/p\u003e\n"],["\u003cp\u003eYou can map input variables from the main integration to the sub-integration, and map sub-integration output variables to the main integration when running a single integration with a synchronous execution strategy.\u003c/p\u003e\n"]]],[],null,["# Call Integration task\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nCall Integration task\n=====================\n\nThe **Call Integration** task lets you invoke or call other integrations created within your Google Cloud project.\n\nThe **Call Integration** task is useful in scenarios where you need to define multiple small integrations (sub-integrations) that is controlled using a main integration (parent integration). After running a sub-integration, you can also\nread the response of the sub-integration in your main integration.\n\nBefore you begin\n----------------\n\n- The **Call Integration** task uses the API trigger to identify and call other integrations and sub-integrations. Therefore, you must ensure that the integrations you want to call are configured using the API trigger. For information about configuring an API trigger see [API trigger](/application-integration/docs/configuring-api-trigger).\n- Ensure that you have [attached a user-managed service account](/application-integration/docs/access-control#add-service-account) to your integration. If your integration does not have user-managed service account configured, then by default the [default service account](/application-integration/docs/access-control#default-service-account) (`service-`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`@gcp-sa-integrations.iam.gserviceaccount.com`) is used for authentication.\n- Ensure that your service account has the **Application Integration Invoker** IAM role. For information about granting roles to a service account, see [Manage access to service accounts](/iam/docs/manage-access-service-accounts).\n\nConfigure the Call Integration task\n-----------------------------------\n\nTo configure the **Call Integration** task:\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. In the navigation menu, click **Integrations** .\n\n\n The **Integrations** page appears listing all the integrations available in the Google Cloud project.\n3. Select an existing integration or click **Create integration** to create a new one.\n\n\n If you are creating a new integration:\n 1. Enter a name and description in the **Create Integration** pane.\n 2. Select a region for the integration. **Note:** The **Regions** dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, click **Enable Region** . See [Enable new region](/application-integration/docs/enable-new-region) for more information.\n 3. Select a service account for the integration. You can change or update the service account details of an integration any time from the info **Integration summary** pane in the integration toolbar. **Note:** The option to select a service account is displayed only if you have enabled integration governance for the selected region.\n 4. Click **Create** . The newly created integration opens in the *integration editor*.\n\n\n4. In the *integration editor* navigation bar, click **Tasks** to view the list of available tasks and connectors.\n5. Click and place the **Call Integration** element in the integration editor.\n6. Click the **Call Integration** task element on the designer to view the **Call Integration** task configuration pane.\n7. Configure the following sub integration details:\n 1. **API Trigger ID:** Type the [API trigger ID](/application-integration/docs/configuring-api-trigger#configure-an-api-trigger) of the integration that you want to call. You can call a single integration or multiple integrations with the same trigger ID.\n 2. **Run all integrations with this API Trigger ID:** Select this option to call all the integrations that have the same API **Trigger ID** .\n\n\n For example, if integration\n `A` and integration `B`, have the same API\n **Trigger ID** , both the integrations `A` and `B`\n are run.\n\n\n | **Note** : If you select this option, the response from the sub-integrations will not be available in the main integration. If you want to access the response of the sub-integrations, select the **Run a single integration** option.\n 3. **Run a single integration** : Select this option to call only the integration specified in the **Integration name** field. You can access and map the response from the sub-integration by configuring the fields detailed in [Map sub-integration response variables](#params).\n\n\n 4. **Execution strategy:** Select the execution modes for the sub-integrations that you want to call.\n - **SYNC** : Runs the sub-integration in synchronous mode. In this mode, the main integration waits for the sub-integrations to complete before continuing with the downstream tasks.\n\n \u003cbr /\u003e\n\n - **ASYNC** : Runs the sub-integration in asynchronous mode. In this mode, the main integration does not wait for the sub-integrations to complete. Immediately after calling the sub integrations, the main integration runs the downstream tasks.\n\n\n If this option is selected, set the **Execution delay (in milliseconds)**. When set, this specifies the\n time delay until the integration is run.\n\n \u003cbr /\u003e\n\n\n All changes to the properties are saved automatically.\n\nMap sub-integration response variables\n--------------------------------------\n\nThe following table describes the configuration properties to map variables between the main integration and sub-integrations:\n\nBest practices\n--------------\n\nFor information about the usage limits that apply to the **Call Integration** task, see [Usage limits](/application-integration/docs/quotas#usage-limits).\n\nError handling strategy\n-----------------------\n\n\nAn error handling strategy for a task specifies the action to take if the task fails due to a [temporary error](/application-integration/docs/error-handling). For information about how to use an error handling strategy, and to know about the different types of error handling strategies, see [Error handling strategies](/application-integration/docs/error-handling-strategy).\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
