例: メール コンテンツのカスタマイズ
ここでは、既定のメール テンプレートを変更する方法の例をいくつか紹介します。既存のテンプレート タイプと Jira での設定方法については、次のガイドを参照してください。
カスタマイズされたオンボーディング手順の追加
テンプレート: usersignup.vm
More about templates: Templates: Batched issue notifications and other events, Templates: Separate issue notifications and other events
usersignup.vm テンプレートでは、新しいユーザーに送信される通知を制御します。次の例に示すように、オンボーディング手順、または外部リンクをフッターの前に追加できます。
#rowWrapperNormalBegin()
<Your onboarding instructions>
#rowWrapperNormalEnd()
#parse("templates/email/html/includes/footer.vm")会社のロゴの追加
テンプレート: 任意、最も一般的には、footer.vm または header.vm
More about templates: Templates: Batched issue notifications and other events, Templates: Separate issue notifications and other events
ロゴを追加する方法は以下のとおりです。
Add the image file to the ZIP archive you downloaded from Jira. You should create a new folder for it called "images" at the top of the hierarchy, next to email and email-batch.
Refer to the image file in your templates starting with:
${baseurl}/templates/images/例:
<img src="${baseurl}/templates/images/logo.png">Jira will send the image together with notifications.
コンテンツの代わりに課題の URL を表示
テンプレート: 課題通知用テンプレート (バッチ処理および個別)
More about templates: Templates: Batched issue notifications and other events, Templates: Separate issue notifications and other events
次のスニペットを使用して、課題の URL を生成します。この URL では、課題の概要が URL のテキストとして表示されます。要約を表示したくない場合はそれを別のものに変更できます。
<a href='${baseurl}/browse/${issue.getKey()}'>$textutils.htmlEncode($issue.getSummary())</a>URL を取得したら、課題通知用のテンプレートの 1 つの中で使用します。たとえば、issuecreated.vm を変更したい場合はその内容を次のスニペットに置き換える必要があります。
#disable_html_escaping()
#defaultMailHeader("email.event.activity.created.issue", $issue.reporter)
#set($link ="<a href='${baseurl}/browse/${issue.getKey()}'>$textutils.htmlEncode($issue.getSummary())</a>")
#rowWrapperNormal($link)
#parse("templates/email/html/includes/footer.vm")セキュリティ レベルに基づく条件付きコンテンツの表示
テンプレート: 課題通知用テンプレート (バッチ処理および個別)
More about templates: Templates: Batched issue notifications and other events, Templates: Separate issue notifications and other events
条件付きコンテンツを表示する方法は以下のとおりです。
次の Velocity スニペットを追加して、セキュリティ レベルの名前を定義します。
#if ($issue.securityLevel) #(set($issueSecurityLevel = $issue.securityLevel.getString(“name”)) … #end課題が定義されたセキュリティ レベルと一致する場合は、コンテンツを表示します。
#if($issueSecurityLevel == "My Security Level") The content you'd like to display for this security level. #end