例: メール コンテンツのカスタマイズ
ここでは、既定のメール テンプレートを変更する方法の例をいくつか紹介します。既存のテンプレート タイプと Jira での設定方法については、次のガイドを参照してください。
カスタマイズされたオンボーディング手順の追加
テンプレート: usersignup.vm
テンプレートの詳細: テンプレート: 課題のバッチ通知とその他のイベント、テンプレート: 個別の課題通知とその他のイベント
usersignup.vm テンプレートでは、新しいユーザーに送信される通知を制御します。次の例に示すように、オンボーディング手順、または外部リンクをフッターの前に追加できます。
#rowWrapperNormalBegin()
<Your onboarding instructions>
#rowWrapperNormalEnd()
#parse("templates/email/html/includes/footer.vm")会社のロゴの追加
テンプレート: 任意、最も一般的には、footer.vm または header.vm
テンプレートの詳細: テンプレート: 課題のバッチ通知とその他のイベント、テンプレート: 個別の課題通知とその他のイベント
ロゴを追加する方法は以下のとおりです。
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 は通知と一緒に画像を送信します。
コンテンツの代わりに課題の URL を表示
テンプレート: 課題通知用テンプレート (バッチ処理および個別)
テンプレートの詳細: テンプレート: 課題のバッチ通知とその他のイベント、テンプレート: 個別の課題通知とその他のイベント
次のスニペットを使用して、課題の 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")セキュリティ レベルに基づく条件付きコンテンツの表示
テンプレート: 課題通知用テンプレート (バッチ処理および個別)
テンプレートの詳細: テンプレート: 課題のバッチ通知とその他のイベント、テンプレート: 個別の課題通知とその他のイベント
条件付きコンテンツを表示する方法は以下のとおりです。
次の 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