Consultez la liste des connecteurs compatibles avec Application Integration.

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 d'intégration d'appels 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-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 :

  1. Dans la console Google Cloud, accédez à la page Application Integration.

    Accéder à Application Integration

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

  3. 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 :

    1. Saisissez un nom et une description dans le volet Create Integration (Créer une intégration).
    2. Sélectionnez une région pour l'intégration.
    3. 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 Récapitulatif de l'intégration de la barre d'outils d'intégration.
    4. Cliquez sur Créer.

    Cela entraîne son ouverture dans l'éditeur d'intégrations.

  4. 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.
  5. Cliquez sur l'élément Call Integration et placez-le dans l'éditeur d'intégration.
  6. 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.
  7. 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.

    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 de la 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 Résultat de la sous-intégration à partir duquel effectuer le mappage, puis sélectionnez le paramètre 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.

Étape suivante