テンプレート: 課題通知とその他のイベントを分離
これは、Jira の個別課題通知に関するページです (バッチ処理された課題の更新は無効化されています)。
バッチ処理された課題通知を使用している場合は、ガイド「バッチ処理された課題通知」を確認してください。
どの通知を使用しているのかわからない場合は、さまざまな通知タイプの詳細をご確認ください。
Jira からダウンロードした ZIP アーカイブには、使用可能なすべての設定オプションのテンプレートが含まれています。特に、すべてが設定に適用されるわけではないため、ファイルとその依存関係は簡単に失われてしまいます。このページで、テンプレートとそれが制御する通知についてご確認ください。
メール テンプレートのカスタマイズ例が必要な場合は、ガイド「例: メール コンテンツのカスタマイズ」をご確認ください。
定義
多くの場合、このガイドにはテンプレートとインクルードという 2 つの定義があります。すべてベロシティ テンプレートであるため、それらを理解する最良の方法として、次の内容をご覧ください。
テンプレート: 基本的に、テンプレートはメールで受け取る通知です。特定の通知の外観をカスタマイズする場合は、テンプレートを変更する必要があります。
インクルード: インクルードは単独では使用されず、常にテンプレート内で参照されます。複数のテンプレートで再利用されるアイテムの外観をカスタマイズする場合は (フッターやヘッダーの変更など)、インクルードを変更する必要があります。
一部のテンプレートには、他のテンプレートから解析されたインクルードやコンテンツが含まれています。それらのファイルのカスタマイズが必要になる場合もあります。インクルードおよび解析済みテンプレートの各列を使用して、追加の調整が必要なコンテンツがテンプレートに含まれているか確認します。
課題の通知
Jira 課題に関する情報を含む通知 (要約メール) をカスタマイズする場合は、次のテーブルに表示されているファイルを調整する必要があります。
ディレクトリ: templates/email/html
次のテンプレートで参照される課題のフィールドには、特定のフィールドのデータが表示されます。それらのフィールドは templates/email/html/fields にあります。
課題のライフサイクル
| 名前 | 説明 | インクルード | パターン | フィールド |
|---|---|---|---|---|
| issuecreated.vm | 課題が作成されました。 |
|
|
|
| issuedeleted.vm | 課題が削除されました。 |
|
| - |
| issueassigned.vm | 課題が誰かに割り当てられまた。 |
|
|
|
| issuresolved.vm | 課題が解決しました。 |
|
|
|
| issueclosed.vm | 課題が終了しました。 |
|
|
|
| issuereopened.vm | 課題が再開されました。 | - | - | - |
| issueupdated.vm | 課題が更新されました。 |
|
|
|
| issuemoved.vm | 課題が別のプロジェクト、課題タイプなどに移動されました。 |
|
| - |
| issuegenericevent.vm | 課題の汎用イベント |
|
|
|
課題のコラボレーション
| 名前 | 説明 | インクルード | パターン | フィールド |
|---|---|---|---|---|
| issuecommented.vm | 課題にコメントが付けられました。 |
|
|
|
| issuecommentedited.vm | 課題のコメントが編集されました。 |
|
|
|
| issuementioned.vm | 課題の中で他ユーザーからメンションされました。 |
|
|
|
| issuenotify.vm |
|
|
|
課題のアーカイブ
| 名前 | 説明 | インクルード | パターン |
|---|---|---|---|
| issuearchived.vm | 課題はアーカイブされました。 |
|
|
| issuerestored.vm | 課題がアーカイブから復元されました。 |
|
|
課題の作業ログ
| 名前 | 説明 | インクルード | パターン | フィールド |
|---|---|---|---|---|
| issueworklogdeleted.vm | 課題の作業ログが削除されました。 | - | ||
| issueworklogged.vm | 課題に作業が記録されました。 | - | ||
| issueworklogupdated.vm | 課題の作業ログが更新されました。 | - | ||
| issueworkstarted.vm | 課題で作業を開始しました。 |
|
|
|
| issueworkstopped.vm | 作業が停止しました。 |
|
|
|
その他の通知
これらの通知は、共有フィルターやユーザー管理などの他のイベントを制御します。さまざまな通知タイプの詳細をご確認ください。
パターン
パターン テンプレートを編集する必要はほとんどありません。パターン テンプレートには、アクション ボタン、タイトル、テキスト段落など、Jira に共通する再利用可能なコンポーネントが含まれています。いずれにしてもテンプレートの内容をチェックするには、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