自定义JIRA邮件模板

本帖最后由 maid 于 2012-8-18 11:13 编辑

JIRA 会根据不同的事件使用不同的邮件模板。 模板引擎使用 Apache Jakarta Velocity。 这是一个相对容易使用的模板语言,而且可以调用java 对象。

邮件模板位置

要自定义邮件模板内容, 请按照下面步骤操作。

  1. 根据JIRA版本,找到以下路径:
    Standalone: atlassian-jira/WEB-INF/classes/templates/email/
    Source: jira/src/etc/java/templates/email/
    WAR: webapp/WEB-INF/classes/templates/email/
  2. 在这个路径下有三个子文件夹: html, text 以及 subject。 html 子文件夹包含了html格式的邮件模板, 而 text 子文件夹包含了纯文本格式的邮件模板。 subject 子文件夹用于生成发送邮件的主题。 这些模板会在事件触发后,发送相应命名的邮件。
  3. 用你常用的文本编辑器打开模板。 请参阅邮件模板中的Velocity 代码 以及Velocity Users Guide, 按照你的需要自定义模板内容。
  4. 重新启动JIRA

高级定制

问题 会被放入vm 模板中。 请注意一些问题会执行 /includes/summary-topleft.vm 中的代码。 例如, 通过调用 $issue.getProject() 方法允许你根据不同的项目甚至自己创建逻辑条件,来显示不同的邮件内容。
请参阅 Adding Custom Fields to Email.