Consultez les connecteurs compatibles avec Application Integration.

Déclencheur Jira Cloud

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

Avant de commencer

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

  • Administrateur du connecteur (roles/connectors.admin)
  • Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès.

Accordez 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 Jira Cloud

Pour ajouter un déclencheur Cloud Jira à 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 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 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 détails du compte de service d'une intégration à tout moment à partir du volet Integration summary (Résumé de l'intégration) dans la barre d'outils de l'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égration, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
  5. Cliquez sur l'élément Déclencheur Cloud Jira et placez-le dans l'éditeur d'intégration.
  6. Pour configurer le déclencheur Jira Cloud, vous pouvez utiliser une connexion Jira Cloud existante disponible dans Integration Connectors ou créer une connexion Jira Cloud à l'aide de l'option de création de connexion intégrée.

Configurer un déclencheur Jira Cloud à 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. Par conséquent, vous ne pouvez utiliser qu'une connexion Jira Cloud avec l'abonnement aux événements activé pour configurer le déclencheur.

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

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

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

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

    3. Type d'abonnement aux événements:sélectionnez le type d'abonnement aux événements 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 aux événements compatibles.
    4. Compte de service: sélectionnez un compte de service disposant des rôles IAM requis pour le déclencheur Jira Cloud.
  4. Cliquez sur OK pour terminer la configuration du déclencheur et fermer la page.

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

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

  1. Cliquez sur l'élément Déclencheur Cloud Jira dans l'éditeur d'intégration 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 Créer une connexion:
    1. À l'étape 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 les détails de la nouvelle connexion Jira Cloud:
      1. Connector version (Version du connecteur) : choisissez une version disponible du connecteur Jira Cloud dans la liste déroulante.
      2. Connection Name (Nom de connexion) : saisissez un nom pour la connexion Jira Cloud.
      3. (Facultatif) Description : saisissez une description de la connexion.
      4. (Facultatif) Activer Cloud Logging:cochez cette case pour stocker toutes les données de journal de la connexion.
      5. Service Account (Compte de service) : sélectionnez un compte de service disposant des rôles IAM requis pour la connexion Jira Cloud.
      6. Enable event subscription (Activer l'abonnement aux événements) : sélectionnez cette option pour créer et activer un nouvel abonnement à des événements pour la connexion Jira Cloud. Vous pouvez uniquement activer les abonnements aux événements ou inclure également des entités, des opérations et des actions de connexion.
      7. (Facultatif) Développez la section Paramètres avancés pour configurer les paramètres du nœud de connexion.

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

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

      5. Cliquez sur Suivant.
    5. À l'étape Event subscription details (Détails de l'abonnement aux événements), indiquez les détails du compte Jira Cloud dans lequel les abonnements aux événements seront créés.
      1. Destination Type (Type de destination) : sélectionnez Host address (Adresse de l'hôte).
      2. Host (Hôte) : saisissez l'URL d'enregistrement de votre compte Jira Cloud. Des abonnements aux événements seront créés pour cette URL.
      3. Username (Nom d'utilisateur) : saisissez le nom d'utilisateur pour accéder à l'URL d'inscription fournie.
      4. 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. Récapitulatif: vérifiez les détails de la connexion à Jira Cloud fournis.
    7. Cliquez sur Create (Créer) pour terminer la création d'une connexion Jira Cloud.
  6. Type d'abonnement aux événements:sélectionnez le type d'abonnement aux événements 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 aux événements compatibles.
  7. Cliquez sur OK et fermez la page.

Sortie du déclencheur

La configuration de l'abonnement à l'événement par le déclencheur Cloud Jira prend quelques minutes. Vous pouvez consulter l'état de votre abonnement aux événements dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Le déclencheur Cloud Jiira indique l'état d'un abonnement à un événement. Les états suivants sont disponibles:

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

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

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

image montrant le volet de configuration du déclencheur Jira Cloud image montrant le volet de configuration du déclencheur Jira Cloud

Variable de sortie du déclencheur

Pour chaque événement, le déclencheur Cloud Jira 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 la charge utile Jira Cloud de sortie.

Afficher les abonnements aux événements

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

  1. Accédez à Integration Connectors > 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 d'événements de la connexion s'affichent.

Modifier le déclencheur Jira Cloud

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

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

  1. Cliquez sur l'élément Déclencheur Cloud Jira dans l'éditeur d'intégration pour ouvrir le volet de configuration du déclencheur.
  2. Cliquez sur Configurer un déclencheur Jira Cloud.
  3. Procédez comme suit sur la page Éditeur de déclencheurs d'événements de connecteur:
    1. Pour conserver l'abonnement à l'événement configuré précédemment, cliquez sur Conserver, sinon cliquez sur Supprimer.
    2. Mettez à jour les détails de la configuration de la connexion et de l'abonnement aux événements selon vos besoins.
    3. Cliquez sur OK.
  4. Vous pouvez afficher les détails mis à jour de la connexion et de l'abonnement aux événements dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Types d'abonnements aux événements compatibles

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

Types d'abonnements aux événements Description
attachment_created Une pièce jointe est créée 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 est 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 est mis à jour.
filter_created Un filtre Jira est créé.
filter_deleted Un filtre Jira est 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 a été mis à jour.
issuelink_created Un lien vers un problème est créé pour une instance Jira.
issuelink_deleted Le lien vers un problème pour une instance Jira est supprimé.
option_issuelinks_changed Un lien vers un problème existant pour une instance Jira a été modifié ou mis à jour.
option_subtasks_changed les tâches secondaires d’un problème ont été mises à jour ou modifiées.
option_voting_changed Le nombre de votes pour un problème Jira a été modifié.
option_watching_changed Les observateurs ou la liste des utilisateurs ajoutés pour regarder 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 les utilisateurs, y compris les administrateurs qui utilisent l'interface du 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 est supprimée.
worklog_updated Une entrée de journal de travail est modifiée ou mise à jour.

Quotas et limites

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

Étape suivante