Configurez un déclencheur web Jira pour déclencher une action chaque fois qu\'un événement se produit dans le projet Jira. Cet exemple montre comment créer un Robot de tâches avec un déclencheur web Jira pour envoyer un e-mail à une boîte aux lettres Microsoft 365 Outlook lorsque l\'utilisateur spécifié crée un ticket dans le projet Jira indiqué.

Le déclencheur web Jira surveille un projet Jira nommé ABC pour détecter les nouveaux tickets (événement Création de ticket) créés par un utilisateur nommé XYZ. Lorsque l\'utilisateur crée un ticket, le déclencheur lance les actions Microsoft 365 Outlook suivantes qui envoient un e-mail à la boîte aux lettres Microsoft 365 Outlook. Cet e-mail inclut le résumé Jira et la description avec l\'ID de ticket Jira comme objet.

Prérequis

Assurez-vous de respecter les prérequis suivants :
  • Prérequis mentionnés dans Prérequis des déclencheurs web Jira.
  • Jira secret client et Microsoft 365 nom d\'utilisateur stockés dans le Credential Vault.
  • Une connexion OAuth pour l\'instance Jira dans laquelle le projet est disponible et le compte Microsoft 365 Outlook.
  • Une variable d\'enregistrement nommée TriggerData.

Procédure

  1. Effectuez les étapes suivantes pour créer un Robot de tâches
    1. Dans le volet de gauche, cliquez sur Automatisation.
    2. Cliquez Créer > Bot de tâche.
      L\'assistant Create Task Bot s\'affiche.
    3. Saisissez un nom approprié pour le robot dans le champ Nom.
      Tous les robots sont stockés dans le dossier <\Bots> par défaut.
    4. Facultatif : Ajoutez une description pour le robot dans le champ Description.
    5. Facultatif : Cliquez sur Choisir et suivez les instructions pour enregistrer le Bot dans un autre dossier.
    6. Cliquez sur Créer et modifier.
      Le robot est créé et la page éditeur de robots s\'affiche.
  2. Effectuez les étapes suivantes pour ajouter et configurer le déclencheur web Jira.
    1. Cliquez sur Déclencheurs > Jira , puis double-cliquez ou faites glisser Déclencheur Web pour ajouter le déclencheur Web à la section Déclencheurs.
    2. Sélectionnez Problème créé dans la liste déroulante Écouter l\'événement.
    3. Configurez les critères de filtrage des événements dans Critères de filtrage en utilisant l\'une des options suivantes :
      • Requête : Saisissez la requête JQL suivante project= "ABC" AND reporter= "XYZ".
      • Condition : réalisez les étapes suivantes pour créer une condition de filtre à l\'aide du générateur de conditions.
        1. Sélectionnez AND > Ajouter une condition.
        2. Configurez la première condition avec ID comme Type de condition, Égal à comme Sélectionner l\'opération, et ABC comme Valeur.
        3. Cliquez sur Ajouter pour ajouter la condition.
        4. Cliquez sur Ajouter une condition.
        5. Configurez la deuxième condition avec Reporter comme Type de condition, Égal à comme Sélectionner l\'opération, et XYZ comme Valeur.
        6. Cliquez sur Ajouter pour ajouter la deuxième condition.
      Consultez la section Critères de filtrage (facultatif) dans Déclencheurs Web Jira pour plus d\'informations sur la façon de créer des critères de filtrage.
    4. Cliquez sur Choisir pour choisir la connexion OAuth préconfigurée dans la fenêtre modale Choisir une connexion OAuth.
    5. Sélectionnez Secret client à vérifier pour l\'événement reçu > Identifiants > Choisir et suivez les invites dans la fenêtre modale Sélectionner un identifiant pour sélectionner le Jira Secret client disponible dans le Credential Vault.
    6. Sélectionnez TriggerData dans la liste déroulante Réponse (facultatif).
      Cette variable d\'enregistrement capture les données de réponse du déclencheur. Les données de réponse du déclencheur contiennent toutes les informations concernant l\'événement dans lequel le changement s\'est produit, sous forme de paires clé-valeur.
  3. Procédez comme suit pour ajouter et configurer l\'action Microsoft 365 Outlook Connect.
    1. Cliquez sur Actions > Microsoft 365 Outlook , puis double-cliquez ou faites glisser l\'action Se connecter pour l\'ajouter à la section Actions.
    2. Cloud Azure : Sélectionnez Azure Global.
      Si vous disposez d\'une version Microsoft 365 Outlook Gouvernement, sélectionnez Azure US GCC High.
    3. Sélectionnez Géré par la Control Room dans la liste déroulante Mode d\'authentification OAuth2.
    4. Cliquez sur Choisir dans Connexion et suivez les instructions dans la fenêtre modale Choisir une connexion OAuth pour sélectionner la connexion OAuth pour le compte Microsoft 365 Outlook.
    5. Cliquez sur Identifiant > Choisir dans Nom d\'utilisateur, et suivez les instructions dans la fenêtre modale Sélectionner un identifiant pour choisir le nom d\'utilisateur Microsoft 365.
    6. Facultatif : Saisissez un nom de session approprié dans Créer une session Microsoft 365 Outlook.
      Le système définit Microsoft365OutlookSession comme nom de session par défaut.
  4. Effectuez les étapes suivantes pour ajouter et configurer l\'action Microsoft 365 Outlook Send.
    1. Cliquez sur Actions > Microsoft 365 Outlook , puis double-cliquez ou faites glisser l\'action Envoyer pour l\'ajouter à la section Actions.
    2. Saisissez le nom de la session que vous avez renseigné lors de la configuration de l\'action Connecter.
      Si le nom par défaut est conservé, le système préremplit Microsoft365OutlookSession comme session Microsoft 365 Outlook.
    3. Saisissez l\'identifiant e-mail auquel le système doit transférer les informations Jira dans À.
    4. Entrez $TriggerData{"issue.key"}$ dans Objet.
      La clé de ticket Jira est définie comme objet de l\'e-mail.
    5. Sélectionnez code HTML, et saisissez Résumé - $TriggerData{"issue.fields.summary"}$. Description : $TriggerData{"issue.fields.description"}$ dans Type de corps de l\'e-mail.
      Le résumé et la description Jira sont définis comme le corps de l\'e-mail.
  5. Cliquez sur Enregistrer pour enregistrer l\'automatisation.
Lorsque vous cliquez sur Exécuter > Exécuter avec des déclencheurs, le système active le déclencheur et le déclencheur commence à écouter l\'événement Création de ticket dans le projet Jira surveillé. Lorsque l\'utilisateur XYZ crée un nouveau ticket dans le projet Jira ABC, le déclencheur lance les actions configurées. La boîte aux lettres Microsoft 365 Outlook reçoit un e-mail contenant le résumé et la description Jira avec l\'identifiant du ticket Jira comme objet.