Consultez la liste des connecteurs compatibles avec Application Integration.

Déclencheur Cloud Jira

Le déclencheur Jira Cloud est un déclencheur d'événement de connecteur qui vous permet d'appeler une intégration basée sur les événements Jira Cloud auxquels vous êtes abonné dans votre connexion Cloud Jira.

Important:Integration Connectors est un composant facturable de Google Cloud. Pour en savoir plus sur les coûts et les frais d'utilisation d'Integration Connectors, consultez les tarifs d'Integration Connectors.

Avant de commencer

Si vous envisagez de créer ou de configurer une connexion pour le déclencheur Cloud Jira, assurez-vous de disposer du rôle IAM suivant sur le projet:

• Administrateur des connecteurs (roles/connectors.admin)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer les accès.

Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le déclencheur Cloud Jira:

• Demandeur Application Integration (roles/integrations.integrationInvoker)

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.

Ajouter le déclencheur Cloud Jira

Pour ajouter un déclencheur Jira Cloud à votre intégration, 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 Integrations (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 détails du compte de service d'une intégration à tout moment depuis le volet Résumé de l'intégration de dans 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.

   La page de l'éditeur d'intégration s'affiche.

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 du déclencheur Jira Cloud et placez-le dans l'éditeur d'intégrations.

Pour configurer le déclencheur Jira Cloud, vous pouvez soit utiliser une connexion Jira Cloud existante disponible dans Integration Connectors, soit créer une connexion Jira Cloud à l'aide de l'option de création de connexion intégrée.

Configurer un déclencheur Cloud Jira à l'aide d'une connexion existante

Vous pouvez configurer le déclencheur Jira Cloud à l'aide d'une connexion Jira Cloud existante dans Integration Connectors. Notez que le déclencheur Jira Cloud est un déclencheur d'événement de connecteur. Vous ne pouvez donc configurer le déclencheur qu'à l'aide d'une connexion Cloud Jira avec un abonnement à des événements activé.

Pour savoir comment configurer un déclencheur Jira Cloud à l'aide d'une nouvelle connexion Cloud Jira, consultez Configurer un déclencheur Cloud Jira à l'aide d'une nouvelle connexion.

Pour configurer un déclencheur Jira Cloud à l'aide d'une connexion Cloud Jira existante, procédez comme suit:

1. Cliquez sur l'élément Jira Cloud trigger dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur.
3. Fournissez les informations de configuration suivantes sur la page Éditeur de déclencheur d'événements de connecteur :
   1. Region (Région) : sélectionnez la région de votre connexion cloud Jira.
   2. Connection (Connexion) : sélectionnez la connexion Jira Cloud que vous souhaitez utiliser.

      Application Integration n'affiche que les connexions Cloud Jira qui sont actives et pour lesquelles un abonnement à un événement est activé.

   3. Type d'abonnement à un événement:sélectionnez le type d'abonnement à un événement qui déclenche l'intégration. Pour en savoir plus sur les types d'abonnements à des événements compatibles avec ce déclencheur, consultez Types d'abonnements à des événements compatibles.
   4. Service Account (Compte de service) : sélectionnez un compte de service doté des rôles IAM requis pour le déclencheur Cloud Jira.
4. Cliquez sur OK pour terminer la configuration du déclencheur et fermer la page.

Configurer un déclencheur Cloud Jira à l'aide d'une nouvelle connexion

Pour configurer le déclencheur Jira Cloud à l'aide d'une nouvelle connexion Cloud Jira, procédez comme suit:

1. Cliquez sur l'élément Jira Cloud trigger dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur.
3. Ignorez le champ Région.
4. Cliquez sur Connexion, puis sélectionnez l'option Créer une connexion dans le menu déroulant.
5. Procédez comme suit dans le volet Create Connection (Créer une connexion) :
   1. À l'étape Location (Emplacement), choisissez l'emplacement de la nouvelle connexion Jira Cloud :
      1. Région:sélectionnez une région dans la liste déroulante.
      2. Cliquez sur Suivant.
   2. À l'étape Connection Details (Détails de la connexion), fournissez des informations sur la nouvelle connexion cloud Jira :
      1. Connector version (Version du connecteur) : choisissez une version disponible du connecteur Cloud Jira dans la liste déroulante.
      2. Connection Name (Nom de la connexion) : saisissez un nom pour la connexion cloud Jira.
         Remarque:Les noms de connexion doivent répondre aux critères suivants :

         • Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
         • Les lettres doivent être en minuscules.
         • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
         • Les noms de connexion ne peuvent pas dépasser 63 caractères.
      3. (Facultatif) Description : saisissez une description de la connexion.
      4. (Facultatif) Activer Cloud Logging:cochez cette case pour stocker toutes les données de journaux de la connexion.
      5. Service Account (Compte de service) : sélectionnez un compte de service doté des rôles IAM requis pour la connexion cloud Jira.
      6. Enable event subscription (Activer l'abonnement aux événements) : sélectionnez cette option pour créer et activer un abonnement à un événement pour la connexion Cloud Jira. Vous pouvez soit activer uniquement les abonnements aux événements, soit inclure des entités, opérations et actions de connexion.
         Remarque:Les étapes de configuration de connexion supplémentaires suivantes sont requises si vous choisissez d'activer des entités, des opérations et des actions pour la connexion :

         • Destinations
         • Authentification
      7. (Facultatif) Développez Paramètres avancés pour configurer les paramètres du nœud de connexion.

         Pour plus d'informations sur les paramètres de nœud de connexion pour Jira Cloud, consultez la documentation sur la connexion au cloud Jira.

      8. (Facultatif) Cliquez sur + Ajouter un libellé pour ajouter un libellé à la connexion sous la forme d'une paire clé-valeur.
      9. Cliquez sur Suivant.
   3. À l'étape Destinations, fournissez les détails du compte Cloud Jira :
      1. Type de destination:sélectionnez Adresse de l'hôte.
      2. Host (Hôte) : saisissez le nom d'hôte ou l'adresse IP de votre compte Cloud Jira.
      3. Cliquez sur Suivant.
   4. À l'étape Authentication (Authentification), fournissez les informations d'authentification du compte Cloud Jira :
      1. Nom d'utilisateur:saisissez le nom d'utilisateur permettant d'accéder à l'adresse de destination fournie.
      2. API token (Jeton d'API) : sélectionnez le secret Secret Manager contenant le jeton d'API associé au nom d'utilisateur Jira Cloud.
      3. Version du secret:sélectionnez une version du secret.

      Pour en savoir plus sur la configuration de l'authentification, consultez Configurer l'authentification.

      4. Cliquez sur Suivant.
   5. À l'étape Event subscription details (Détails de l'abonnement à l'événement), fournissez les détails du compte Cloud Jira dans lequel les abonnements aux événements seront créés.
      1. Type de destination:sélectionnez Adresse de l'hôte.
      2. Host (Hôte) : saisissez l'URL d'enregistrement de votre compte Cloud Jira. Des abonnements à des événements seront créés pour cette URL.
      3. Nom d'utilisateur:saisissez le nom d'utilisateur pour accéder à l'URL d'inscription fournie.
      4. API token (Jeton d'API) : sélectionnez le secret Secret Manager contenant le jeton d'API associé au nom d'utilisateur.
      5. Version du secret:sélectionnez une version du secret.
      6. Cliquez sur Suivant.
   6. Review (Examen) : examinez les détails de connexion au cloud Jira fournis.
   7. Cliquez sur Create (Créer) pour finaliser la création d'une connexion cloud Jira.
6. Type d'abonnement à un événement:sélectionnez le type d'abonnement à un événement qui déclenche l'intégration. Pour en savoir plus sur les types d'abonnements à des événements compatibles avec ce déclencheur, consultez Types d'abonnements à des événements compatibles.
7. Cliquez sur OK et fermez la page.

Sortie du déclencheur

Le déclencheur Jira Cloud prend quelques minutes pour terminer la configuration de l'abonnement à un événement. Vous pouvez afficher l'état de votre abonnement à un événement dans le volet de configuration du déclencheur, sous Détails de l'abonnement à un événement.

Le déclencheur Jira Cloud indique l'état d'un abonnement à un événement selon les états suivants:

• Creating: indique que le déclencheur s'abonne à l'abonnement à l'événement.
• Active: indique que le déclencheur a bien été abonné à un abonnement à un événement.
• Error: indique qu'il y a un problème avec l'abonnement à un événement configuré.

En plus de l'état d'abonnement à l'événement, la section Détails de l'abonnement à l'événement affiche également d'autres informations, telles que la région et le nom de la connexion, le nom de l'abonnement à l'événement, etc.

L'image suivante montre un exemple de mise en page du volet de configuration du déclencheur Cloud Jira:

Variable de sortie du déclencheur

Pour chaque événement, le déclencheur Jira Cloud génère une variable de sortie ConnectorEventPayload que vous pouvez utiliser dans vos tâches en aval. La variable de sortie est au format JSON et contient le schéma de charge utile Jira Cloud de sortie.

Afficher les abonnements à des événements

Pour afficher et gérer tous les abonnements à des événements associés à une connexion dans Integration Connectors, procédez comme suit:

1. Accédez à la page Integration Connectors > Connections (Connecteurs d'intégration > Connexions).

   Accéder à la page "Connexions"

2. Cliquez sur la connexion pour laquelle vous souhaitez afficher les abonnements.
3. Cliquez sur l'onglet Abonnements aux événements.

   Tous les abonnements aux événements pour la connexion s'affichent.

Modifier le déclencheur Cloud Jira

Vous pouvez modifier un déclencheur Jira Cloud pour changer ou mettre à jour la configuration de la connexion et les détails de l'abonnement aux événements.

Important:Lorsque vous modifiez un déclencheur Cloud Jira, vous pouvez soit conserver l'abonnement aux événements précédemment configuré qui est associé au déclencheur, soit le supprimer. La suppression d'un abonnement à un événement aura une incidence sur toutes les intégrations publiées qui utilisent cet abonnement.

Pour modifier un déclencheur Cloud Jira, procédez comme suit:

1. Cliquez sur l'élément Jira Cloud trigger dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configure Jira Cloud trigger (Configurer un déclencheur Cloud Jira).
3. Procédez comme suit sur la page Éditeur de déclencheur d'événements de connecteur :
   1. Pour conserver l'abonnement à un événement configuré précédemment, cliquez sur Conserver, sinon cliquez sur Supprimer.
      Avertissement:La suppression d'un abonnement à un événement aura une incidence sur toutes les intégrations publiées qui l'utilisent. Cette tâche est irréversible.
   2. Mettez à jour la configuration de la connexion et les détails de l'abonnement à l'événement, comme vous le souhaitez.
   3. Cliquez sur OK.

Vous pouvez afficher les détails de la connexion et de l'abonnement aux événements mis à jour dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Types d'abonnements à des événements compatibles

Vous pouvez utiliser le déclencheur Jira Cloud pour appeler une intégration pour les types d'abonnement aux événements suivants:

Types d'abonnements à des événements	Description
attachment_created	Un rattachement est créé pour un ticket Jira.
attachment_deleted	La pièce jointe associée à un ticket Jira est supprimée.
board_created	Un tableau Jira est créé.
board_deleted	Un tableau Jira a été supprimé.
comment_created	Un commentaire est ajouté à la demande Jira.
comment_deleted	Un commentaire dans un ticket Jira est supprimé.
comment_updated	Un commentaire existant dans un ticket Jira a été mis à jour.
filter_created	Un filtre Jira est créé.
filter_deleted	Un filtre Jira a été supprimé.
filter_updated	Un filtre Jira existant est mis à jour.
issue_created	Un problème Jira est créé.
issue_deleted	Un problème Jira a été supprimé.
issue_updated	Un problème Jira existant est mis à jour.
issuelink_created	Une association à un problème est créée pour une instance Jira.
issuelink_deleted	Le lien vers le problème d'une instance Jira est supprimé.
option_issuelinks_changed	Un lien existant vers un problème a été modifié ou mis à jour pour une instance Jira.
option_subtasks_changed	Les tâches secondaires pour un problème sont mises à jour ou modifiées.
option_voting_changed	Le nombre de votes pour un problème Jira est modifié.
option_watching_changed	Les observateurs ou la liste des utilisateurs ajoutés pour surveiller un problème Jira ont changé.
project_created	Un projet est créé.
project_deleted	Un projet est supprimé.
project_restored_deleted	Un projet supprimé est restauré.
project_soft_deleted	Un projet est supprimé de sorte qu'il n'est plus visible par aucun utilisateur, y compris les administrateurs utilisant l'interface produit ou l'API.
project_updated	Les détails du projet sont mis à jour.
sprint_closed	Le sprint est terminé.
sprint_created	Un sprint est créé.
sprint_deleted	Un sprint est supprimé.
sprint_updated	Les détails d'un sprint sont modifiés ou mis à jour.
user_created	Un utilisateur est créé.
user_updated	Les détails d'un utilisateur sont modifiés ou mis à jour.
worklog_created	Une entrée de journal de travail est ajoutée.
worklog_deleted	Une entrée de journal de travail a été supprimée.
worklog_updated	Une entrée de journal de travail a été modifiée ou mise à jour.