Exemple de création d\'une automatisation avec le déclencheur web Jira

Créez une automatisation avec le déclencheur web Jira pour envoyer un e-mail à une boîte aux lettres Microsoft 365 Outlook lorsqu\'un nouveau ticket est créé dans un projet Jira spécifique. L\'e-mail inclut l\'identifiant du ticket Jira, le résumé et la description.

Configurez le déclencheur web Jira pour surveiller un projet Jira nommé ABC pour les nouveaux tickets (événement Création de ticket) qu\'un utilisateur nommé XYZ crée. 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 :

Procédure

  1. Dans le volet de gauche, cliquez sur Automatisation.
  2. Cliquez Créer > Bot de tâche.
    L\'assistant Create Task Bot est affiché.
  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 : Vous pouvez ajouter une description pour le robot dans le champ Description.
  5. Facultatif : Vous pouvez utiliser le bouton Choisir pour enregistrer le robot dans un dossier différent.
  6. Cliquez sur Créer et modifier.
    Le robot est créé et le Edit Task Bot est affiché.
  7. Cliquez sur Déclencheurs > Jira , puis double-cliquez ou faites glisser Déclencheur Web pour ajouter le déclencheur Web à la section Déclencheurs.
  8. Sélectionnez Problème créé dans la liste déroulante Écouter l\'événement.
  9. 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.
  10. Cliquez sur Choisir pour choisir la connexion OAuth préconfigurée dans la fenêtre modale Choisir une connexion OAuth.
  11. Sélectionnez Secret client à vérifier pour l\'événement reçu > Identifiants 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.
  12. 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.
  13. Cliquez sur Actions > Microsoft 365 Outlook , puis double-cliquez ou faites glisser l\'action Se connecter pour l\'ajouter à la section Actions.
  14. Configurez l\'action Connecter comme suit :
    1. Cloud Azure : Sélectionnez Azure Global.
      Si vous disposez d\'une version Microsoft 365 Outlook Gouvernement, sélectionnez Azure US GCC High.
    2. Mode d\'authentification OAuth2 : Sélectionnez Managée par la Control Room.
    3. Connexion : Cliquez sur Choisir, et suivez les instructions dans la fenêtre modale Choisir une connexion OAuth pour sélectionner une connexion OAuth appropriée.
    4. Nom d\'utilisateur : Cliquez sur Identifiant > Choisir, et suivez les invites dans la fenêtre modale Sélectionner un identifiant pour sélectionner le nom d\'utilisateur Microsoft 365.
    5. Créer une session Microsoft 365 Outlook Par défaut, Microsoft365OutlookSession est défini comme nom de session.
  15. Cliquez sur Actions > Microsoft 365 Outlook , puis double-cliquez ou faites glisser l\'action Envoyer pour l\'ajouter à la section Actions.
  16. Configurez l\'action Envoyer comme suit :
    1. SessionMicrosoft365Outlook : par défaut, le système sélectionne Microsoft365OutlookSession comme nom de session.
    2. À : entrez l\'identifiant e-mail auquel le système doit transférer les informations Jira.
    3. Objet: Entrez $TriggerData{"issue.key"}$.
      La clé de ticket Jira est définie comme objet de l\'e-mail.
    4. Type de corps de l\'e-mail : Sélectionnez code HTML, et saisissez Résumé - $TriggerData{"issue.fields.summary"}$. Description : $TriggerData{"issue.fields.description"}$.
      Le résumé et la description Jira sont définis comme le corps de l\'e-mail.
  17. Cliquez sur Enregistrer pour enregistrer l\'automatisation.
Cliquez sur Exécuter > Exécuter avec des déclencheurs pour activer le déclencheur. Le déclencheur se met alors à l\'écoute de 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. Vous recevrez un e-mail contenant le résumé et la description Jira avec l\'identifiant du ticket Jira comme objet.