テンプレート: 課題のバッチ通知とその他のイベント
このページは、バッチ処理された課題更新を使用している既定の Jira 通知用です。
個別の課題通知を使用している場合は、ガイド「個別の課題通知」を確認してください。
どの通知を使用しているのかわからない場合は、さまざまな通知タイプの詳細をご確認ください。
Jira からダウンロードした ZIP アーカイブには、使用可能なすべての設定オプションのテンプレートが含まれています。特に、すべてが設定に適用されるわけではないため、ファイルとその依存関係は簡単に失われてしまいます。このページで、テンプレートとそれが制御する通知についてご確認ください。
定義
多くの場合、このガイドにはテンプレートとインクルードという 2 つの定義があります。すべてベロシティ テンプレートであるため、それらを理解する最良の方法として、次の内容をご覧ください。
テンプレート: 基本的に、テンプレートはメールで受け取る通知です。特定の通知の外観をカスタマイズする場合は、テンプレートを変更する必要があります。
インクルード: インクルードは単独では使用されず、常にテンプレート内で参照されます。複数のテンプレートで再利用されるアイテムの外観をカスタマイズする場合は (フッターやヘッダーの変更など)、インクルードを変更する必要があります。
一部のテンプレートには、他のテンプレートから解析されたインクルードやコンテンツが含まれています。それらのファイルのカスタマイズが必要になる場合もあります。インクルードおよび解析済みテンプレートの各列を使用して、追加の調整が必要なコンテンツがテンプレートに含まれているか確認します。
課題の通知
テンプレート
Jira 課題に関する情報を含む通知 (要約メール) をカスタマイズする場合は、次のテーブルに表示されているファイルを調整する必要があります。
ディレクトリ: templates/email-batch/html
| 名前 | 説明 | インクルード | 解析済みテンプレート |
|---|---|---|---|
| IssueUpdateBatcher-subject.vm | バッチ処理された課題更新時のメール件名。 | - | - |
| IssueUpdateBatched-header.vm | メール ヘッダー。以下が含まれます。
| - | - |
| IssueUpdateBatcher-content.vm | メールの主要部分で、課題の更新が表示されます。ただし、更新自体は、このテンプレートに含まれている次のテンプレート (下記) によって取得されます。 |
|
|
| IssueUpdateBatcher-history.vm | 課題の更新の要約: コメント、更新、作業ログ、メンション、課題のステータス (移動、割り当て、アーカイブ、削除など) を提供します。 | - |
|
インクルード
テンプレートの外観や内容の一部をカスタマイズしたい場合は、問題通知のテンプレートで参照される以下のテーブルのファイルを調整する必要が生じる可能性があります。
ディレクトリ: templates/email-batch/html
その他の通知
これらの通知は、共有フィルターやユーザー管理などの他のイベントを制御します。さまざまな通知タイプの詳細を確認する
パターン
パターン テンプレートを編集する必要はほとんどありません。それらのテンプレートには、アクション ボタン、タイトル、テキスト段落など、Jira UI に共通する再利用可能なコンポーネントが含まれています。テンプレートについてチェックしたい場合は、templates/email/html/patterns でご覧いただけます。
テンプレートを共有する
誰かが課題、検索クエリ、またはフィルターをユーザーと共有したときに送信される通知をカスタマイズする場合、次のテーブルに表示されているファイルを調整する必要があります。
ディレクトリ: templates/email/html
| 名前 | 説明 | インクルード | パターン | 解析済みテンプレート |
|---|---|---|---|---|
| share-issue.vm | 他のユーザーが課題を共有しています。 |
|
|
|
| share-jql-search.vm | 他のユーザーが JQL 検索を共有しています。 |
|
|
|
| share-saved-search.vm | 他のユーザーが保存された検索 (フィルター) を共有しています。 |
|
|
|
管理者への問い合わせテンプレート
管理者ユーザーの通信に関連する通知をカスタマイズする場合は、次のテーブルに表示されているファイルを調整する必要があります。
ディレクトリ: templates/email/html
| 名前 | 説明 | インクルード | パターン |
|---|---|---|---|
| contactadministrator.vm | 誰かが、管理者への問い合わせフォームで連絡しようとし、それを Jira 管理者が受信したことを通知します。 |
|
|
| emailfromadmin.vm | Jira 管理者から直接ユーザーに送信されるメール。 |
|
|
ユーザー管理テンプレート
ユーザー アカウントの設定、パスワードのリセットなどの後に送信される通知をカスタマイズする場合は、次のテーブルに表示されているファイルを調整する必要があります。
ディレクトリ: templates/email/html
| 名前 | 説明 | インクルード | パターン |
|---|---|---|---|
| usercreated.vm | 新しいユーザーが作成されました。Jira 管理者への通知です。 |
|
|
| usercreated-nopassword.vm | 外部ディレクトリに新しいユーザーが作成されましたが、それらのユーザーのパスワードを変更できません。Jira 管理者への通知です。 |
|
|
| usersignup.vm | ユーザーが Jira にサインアップした後に受信する通知。 |
| - |
| forgotusername.vm | ユーザーがユーザー名を忘れた場合に受け取る通知。 |
| - |
| forgotpassword.vm | ユーザーがパスワードを忘れた場合に受け取る通知。 |
| - |
他の通知のインクルード
次のテーブルは、メイン テンプレートで参照されているインクルードのリストを示しています。課題通知のテンプレートで使用されているインクルードは含まれていません。それらは、課題通知セクションで触れられています。
ディレクトリ: templates/email/html/includes