Tâche d'appel d'intégration

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 dans les cas où 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-apigee.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 l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
Cliquez sur Développer > Intégrations.
Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.
Si vous créez une intégration :
1. Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
2. Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
3. Cliquez sur Créer.
La page de conception d'intégration s'affiche.
Dans la barre de navigation de la page de conception d'intégration, cliquez sur +Ajouter une tâche ou un déclencheur > Tâches pour afficher la liste des tâches 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 :
1. 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 ou plusieurs intégrations avec le même ID de déclencheur.
2. 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.
  
  Remarque : Si vous sélectionnez cette option, la réponse des sous-intégrations ne sera pas disponible dans l'intégration principale. Si vous souhaitez accéder à la réponse des sous-intégrations, sélectionnez l'option Exécuter une seule intégration.
3. 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.
4. 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 d'une 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

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 la 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. Remarque : Ce champ ne s'affiche que lorsque l'option Exécuter une seule intégration est sélectionnée avec la stratégie d'exécution SYNC.

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 la 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.