Consultez la liste des connecteurs compatibles avec Application Integration.

Déclencheur Cloud Pub/Sub

Le déclencheur Cloud Pub/Sub vous permet d'exécuter votre intégration en fonction des événements de votre middleware Pub/Sub.

Ce déclencheur vous permet d'exécuter une intégration dès qu'un éditeur écrit un message dans le sujet de votre choix. Le sujet peut se trouver dans le même projet Google Cloud que l'intégration. dans un autre projet Google Cloud. Lorsque ce déclencheur s'exécute, il écrit également le message publié dans la variable de sortie CloudPubSubMessage. Selon vos besoins, vous pouvez utiliser cette variable dans vos déclencheurs ou vos tâches en aval.

Pour découvrir comment créer un exemple d'intégration à l'aide d'Application Integration et du déclencheur Cloud Pub/Sub, consultez la section Écouter le sujet Cloud Pub/Sub et envoyer un e-mail.

Avant de commencer

Assurez-vous d'effectuer les tâches suivantes dans votre projet Google Cloud avant de configurer le déclencheur Cloud Pub/Sub.

• Attribuer le rôle Administrateur IAM de projet (roles/resourcemanager.projectIamAdmin) à l'utilisateur qui crée ce déclencheur.
• Activez l'API Pub/Sub pour le projet Google Cloud qui contient votre intégration.
• Vérifiez que vous disposez d'un sujet Cloud Pub/Sub. Pour créer un sujet Pub/Sub :
  1. Accédez à la page "Sujets Pub/Sub" dans Cloud Console.

     Accéder à la page "Sujets Pub/Sub"

  2. Cliquez sur Create a topic (Créer un sujet).
  3. Dans le champ ID du sujet, indiquez un nom de sujet unique.
  4. Cliquez sur Enregistrer.
  Remarque:Il n'est pas nécessaire de créer d'abonnement pour que le déclencheur fonctionne. Application Integration crée automatiquement un abonnement pour un sujet lorsque vous publiez votre intégration. Vous pouvez afficher toutes vos sur la page des abonnements Pub/Sub.

  Premiers pas avec Application Integration 1er décembre 2023, vous serez facturés selon les tarifs de facturation de Pub/Sub. Les abonnements de votre déclencheur Cloud Pub/Sub existant continueront de fonctionner comme avant et ne seront pas facturés. Toutefois, si vous modifier le sujet d'un déclencheur Cloud Pub/Sub existant, la facturation Pub/Sub sera appliquée au déclencheur Cloud Pub/Sub mis à jour.

Pour en savoir plus sur la gestion des accès à l'aide des rôles IAM, consultez la page Contrôle des accès.

Pour plus d'informations sur l'attribution de rôles aux comptes principaux, consultez la page Accorder, modifier et révoquer les accès.

Ajouter un déclencheur Cloud Pub/Sub

Pour ajouter un déclencheur Cloud Pub/Sub à une intégration nouvelle ou existante, procédez comme suit :

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 Liste des intégrations s'affiche. Elle répertorie 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 Créer une intégration.
   2. Sélectionnez une région pour l'intégration.
      Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
   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.
      Remarque:L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
   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égration, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
5. Cliquez sur l'élément de déclencheur Cloud Pub/Sub et placez-le au niveau du concepteur.

Configurer un déclencheur Cloud Pub/Sub

Cliquez sur l'élément Déclencheur Cloud Pub/Sub dans l'éditeur d'intégrations pour afficher le volet de configuration du déclencheur, puis effectuez les tâches suivantes :

1. Spécifiez le sujet que le déclencheur doit écouter dans le champ Sujet Pub/Sub au format suivant :

   projects/PROJECT_ID/topics/TOPIC_ID

   Pour afficher tous les sujets disponibles dans votre projet Google Cloud, consultez la colonne Nom du sujet dans la section Sujets. Vous pouvez également sélectionner un sujet dans un autre projet Google Cloud.

   Remplacez l'élément suivant :
   • PROJECT_ID : le projet Google Cloud dans lequel votre sujet a été créé.
   • TOPIC_ID : l'ID de votre sujet Pub/Sub. Le sujet peut se trouver dans le même projet Google Cloud que celui de votre intégration ou dans un autre projet Google Cloud.
2. Sélectionnez le compte de service que vous souhaitez utiliser pour appeler l'intégration. Vous pouvez également choisir une variable de configuration que vous avez créée dans l'intégration. La valeur de la variable de configuration doit être une adresse e-mail de compte de service au format suivant : [e-mail]. Par exemple, [e-mail].

   Pour savoir comment créer une variable de configuration, consultez Créer une variable. Pour savoir comment créer un compte de service, consultez Créer un compte de service.

   Si vous choisissez une variable de configuration, vous devez attribuer les rôles requis au compte de service auquel la variable de configuration fait référence. Pour en savoir plus sur l'attribution de rôles, consultez la section Rôles IAM requis.

   Si aucun compte de service n'est associé, créez-en un en cliquant sur Créer dans la liste Compte de service.

   Remarque : Commencez par utiliser Application Integration Version du 1er décembre 2023, Lorsque vous configurez le déclencheur Cloud Pub/Sub, vous devez spécifier un compte de service pour le déclencheur. Vos déclencheurs Pub/Sub existants, qui ne sont associés à aucun compte de service, continueront de fonctionner comme auparavant. Toutefois, si vous souhaitez modifier l'un des déclencheurs Pub/Sub existants, vous devez configurer un compte de service pour continuer à utiliser ces déclencheurs.

Par défaut, l'option de délai d'expiration des abonnements est définie sur never expire. Si vous souhaitez définir le délai d'expiration sur une autre valeur, accédez à la page d'abonnement Pub/Sub dans la console Google Cloud, puis modifiez l'abonnement.

Rôles IAM requis pour les comptes de service

Si vous cliquez sur Attribuer lorsque vous sélectionnez un compte de service, les rôles suivants sont automatiquement attribués aux différents comptes de service.

Compte de service	Rôle IAM attribué
Compte de service par défaut d'Application Integration: [e-mail]	Éditeur Pub/Sub (roles/pubsub.editor) Utilisateur du compte de service (roles/iam.serviceAccountUser) Si le projet Google Cloud du sujet Pub/Sub est différent du projet Google Cloud de l'intégration le compte de service par défaut doit disposer du rôle d'éditeur Pub/Sub dans le projet Google Cloud associé au sujet.
Compte de service que vous sélectionnez pour ce déclencheur	Demandeur Application Integration (roles/integrations.integrationInvoker)

Sortie du déclencheur

Pour chaque événement, le déclencheur Cloud Pub/Sub génère une variable de sortie CloudPubSubMessage que vous pouvez utiliser dans vos tâches en aval. La variable est au format JSON et possède la structure PubsubMessage.

Remarques

• La taille maximale d'un message Pub/Sub est de 10 Mo. Pour comprendre toutes les limitations de Pub/Sub, consultez la page Quotas et limites de Pub/Sub.
• Il est possible que Pub/Sub écrive le même message plusieurs fois dans un sujet. Pour comprendre ce comportement de Pub/Sub, consultez la section Distribution de type "au moins une fois". Par conséquent, vous devez concevoir votre intégration de manière à ce qu'elle soit idempotente afin qu'un message ne puisse pas être écrit plusieurs fois dans un sujet.

  Le champ message_id de l'en-tête du message identifie de manière unique un message Pub/Sub.

• Si vous annulez la publication d'une intégration, l'abonnement Pub/Sub n'est pas supprimé pour éviter toute perte de messages. Toutefois, si vous supprimez la version publiée ou toutes les versions d'une intégration, l'abonnement Pub/Sub est également supprimé.

Créer un abonnement avec filtre pour votre intégration

Si vous souhaitez définir un filtre pour l'abonnement Pub/Sub afin de traiter des événements spécifiques dans votre intégration, procédez comme suit :

1. Publiez l'intégration avec le déclencheur Cloud Pub/Sub configuré. Cette étape crée l'abonnement dans le projet d'intégration.
2. Dans la console Google Cloud, accédez à la page Abonnements.

   Accéder à la page "Abonnements"

3. Ouvrez l'abonnement et copiez tous les détails, y compris le nom de l'abonnement.
4. Supprimez l'abonnement existant.
5. Créez un abonnement avec tous les détails de l'abonnement supprimé, y compris son nom, que vous avez copiés à l'étape 3, puis ajoutez un filtre dans le nouvel abonnement.

   L'abonnement nouvellement créé déclenche l'intégration avec les messages filtrés.

Exclusions du Contrat de niveau de service

Le déclencheur Cloud Pub/Sub dépend du Pub/Sub produit. Comme cette dépendance est externe à l'intégration d'applications, les conditions d'utilisation du contrat de niveau de service (SLA) pour l'intégration d'applications ne s'appliquent que lorsque le déclencheur Cloud Pub/Sub lance l'exécution d'une intégration active.

Tarifs

Vous n'avez pas besoin de créer de connecteur pour le déclencheur Cloud Pub/Sub et le déclencheur Salesforce. Toutefois, si vous utilisez la tâche Connecteurs pour vous connecter à Pub/Sub ou à Salesforce, vous êtes facturé pour l'utilisation du connecteur. Pour en savoir plus sur la tarification, consultez la page Tarifs d'Application Integration.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Étape suivante

• Découvrez toutes les tâches et tous les déclencheurs.
• Découvrez comment tester et publier une intégration.
• En savoir plus sur la gestion des erreurs
• Découvrez les journaux d'exécution d'intégration.