Modifier le contenu des notifications JIRA - Valiantys - Atlassian Platinum Partner
logo-bleu_rvb.png
Back

Modifier le contenu des notifications JIRA

Les notifications dans JIRA sont fortement appréciées des utilisateurs. Attention cependant à ne pas en abuser, car elles deviennent alors contre-productive. Il est important de recevoir des notifications ciblées, contenant seulement les informations nécessaires. On se heurte alors à une problématique dans JIRA, comment modifier le contenu des mails de notification ? Ils contiennent par défaut un ensemble de champs, tous ne sont pas utile dans les cas d’utilisation des clients. Il est même parfois nécessaire d’y ajouter de l’information, comme le contenu d’un champ personnalisé. Voici un petit guide pour mettre à jour vos templates de mail.

Selon la distribution de JIRA que vous utilisez, les templates se trouvent à un emplacement différent :

  • <jira-application-dir>/WEB-INF/classes/templates/email pour une version Standalone ou WAR
  • jira/src/etc/java/templates/email pour une version Source de JIRA

Dans ce dossier email, il y a 3 dossiers :

  • html : ce dossier contient les templates de mail en HTML
  • text : ce dossier contient les templates de mail en version texte
  • subject : ce dossier contient les sujets des mails, qui peuvent être également personnalisés.

Si je souhaite par exemple afficher le contenu d’un champ personnalisé lors d’une notification Text sur une demande créée, je dois modifier le fichier text/issuecreated.vm.

Les templates sont définis dans un langage Velocity, qui est assez semblable au HTML, avec une possibilité d’utiliser des variables héritées du contexte d’utilisation. Il est du coup préférable de laisser ces modifications entre les mains d’un développeur. Quoi qu’il arrive, il est important de tester vos modifications sur un environnement JIRA de test avant de les déployer sur votre instance de production. A noter que la modification d’un fichier velocity n’est prise en compte qu’après un redémarrage de JIRA (sauf configuration particulière définie à la fin de cette page).

Le code à ajouter pour afficher votre champ personnalisé dans un template de mail est le suivant :

#if ($issue.getCustomFieldValue("customfield_10000"))
>$stringUtils.leftPad($issue.getCustomField("customfield_10000").name, $padSize):
$issue.getCustomFieldValue("customfield_10000")
#end

Il faudra adapter l’id de votre champ personnalisé. Celui-ci peut être trouve dans l’administration de JIRA en survolant le lien de configuration du champ personnalisé ou encore en base de données dans la table customfield.

Cutted Triangle

Subscribe to the Valiantys Newsletter

Demande enregistrée ! Demande en cours... Ceci n'est pas un email Une erreur s'est produite

In accordance with our privacy policy, we are committed to respecting your personal data.

Contact us

Our Atlassian certified consultants will be happy to answer you.

Join us

We're building the next dream team - Are you in?

Follow us

Nous utilisons des cookies pour le fonctionnement de ce site, pour améliorer son utilisation, personnaliser votre expérience et réaliser des statistiques de visite. Vous pouvez gérer les paramètres et choisir d’accepter ou non certains cookies durant votre navigation. Pour plus d’informations, consultez notre politique de confidentialité. Nos politique de confidentialité

Paramètres de confidentialité

Afin de faciliter votre navigation et de vous apporter le meilleur service possible, nous utilisons des cookies pour améliorer le site aux besoins des visiteurs, notamment selon la fréquentation.  Pour plus d’informations, consultez notre politique de confidentialité. Nos politique de confidentialité

Recaptcha

Google reCAPTCHA est un système conçu pour distinguer les humains des ordinateurs, de telle sorte que les bots soient incapables de remplir les formulaires de manière malveillante au nom d’un être humain.

Analytics

Utilisé pour envoyer des données à Google Analytics sur le périphérique et le comportement du visiteur. Suit l'internaute à travers les appareils et les canaux de marketing. Utilisé par Google Analytics pour diminuer radicalement le taux de requêtes. Enregistre un identifiant unique utilisé pour générer des données statistiques sur la façon dont le visiteur utilise le site.

LinkedIn

Cookies pour une publicité ciblée : Ces cookies peuvent être mis en place au sein de notre site Web par nos partenaires publicitaires. Ils peuvent être utilisés par ces sociétés pour établir un profil de vos intérêts et vous proposer des publicités pertinentes sur d'autres sites Web. Ils ne stockent pas directement des données personnelles, mais sont basés sur l'identification unique de votre navigateur et de votre appareil Internet. Si vous n'autorisez pas ces cookies, votre publicité sera moins ciblée.

Cookies "réseaux sociaux" : Ces cookies sont activés par les services proposés sur les réseaux sociaux que nous avons ajoutés au site Web afin de vous donner la possibilité de partager notre contenu avec votre réseau et vos connaissances. Ils nous permettent également de suivre votre navigation sur d’autres sites Web et d’établir un profil de vos intérêts. Cela peut avoir un impact sur le contenu et les messages affichés sur les autres sites Web que vous consultez. Si vous n'autorisez pas ces cookies, il se peut que vous ne puissiez pas utiliser ou visualiser ces outils de partage.