Astuce JIRA : customisez vos templates d’email sans redémarrage


Publié par
Corentin BRESSON

11 février 2013

C’est grâce au moteur de template Velocity que JIRA génère les emails. Vous pouvez donc customiser vos emails en modifiant les templates Velocity. Cependant, la prise en compte des modifications nécessite un redémarrage de JIRA: cela entraîne une interruption de service et ralentit considérablement le travail.

Heureusement, pendant que vous développez vos nouvelles templates (sur une instance de développement!), vous pouvez utiliser le mécanisme de rechargement automatique des templates en éditant le fichier <JIRA_INSTALLATION_DIRECTORY>/atlassian-jira/WEB-INF/classes/velocity.properties:

  • Changer class.resource.loader.cache de true à false
  • Décommenter #velocimacro.library.autoreload=true

JIRA - template velocity

Avant de vous lancer, soyez tout de même conscient que:

  • La customisation des templates Velocity n’est pas supportée par Atlassian.
  • Lors de la prochaine montée de version de JIRA, il faudra copier manuellement les templates customisées, et éventuellement les porter.
  • Pour JIRA 5.1.x, ce mécanisme de rechargement automatique des templates ne fonctionne qu’avec Tomcat 7 (JRA-29923)

A savoir, le plugin commercial JETI propose un éditeur de template.

Enfin, relisez notre article sur la modification des templates.

A vos templates!