通知スキームを作成する
Jira アプリケーションは、課題のライフサイクルを通じて発生するさまざまなイベント(カスタムイベントを含む) で電子メール通知を生成できます。通知は、特定の電子メールイベントと特定の電子メール受信者を関連付けた通知スキーム (以下を参照) で定義されます。その後、通知スキームは特定のプロジェクトに割り当てられます。
同じ通知スキームを複数のプロジェクトで使用できます。
Jira アプリケーションには、既定の通知スキームと呼ばれる通知スキームが含まれます。通知スキームは、既定ですべての新しいプロジェクトと関連づけられます。つまり、送信 (SMTP) メールサーバーをセットアップ済みの場合、そのメール通知は新しいプロジェクトでアクション (例: 課題の作成) が発生すると、すぐに送信されます。ただし、以下で説明するように、プロジェクト サマリー ページでプロジェクトからこの通知スキームの関連付けを解除できます。また、このスキームを変更したり、必要に応じて特定のプロジェクトに他の通知スキームを作成することもできます。
注意: 次のすべての手順において、Jira 管理者グローバル権限を持つユーザーとしてログインする必要があります。
通知スキームを作成する
- > [課題] を選択します。
- 通知スキームを選択して、Jira インストール内の現在のすべての通知スキームを一覧できる通知スキーム ページを開きます。
- 次のいずれかを実行して、新しい通知スキームの作成を開始します:
- コピーリンクをクリックし、既存の通知スキームをコピーします。イベント受信者が必要としているものにある程度類似している通知スキームがある場合、コピーの作成は新しいスキームを追加するもっとも迅速な方法です。
または - 通知スキームを追加ボタンをクリックします。通知スキームの追加ページで、通知スキームの名前とスキームの短い説明を入力します。
- コピーリンクをクリックし、既存の通知スキームをコピーします。イベント受信者が必要としているものにある程度類似している通知スキームがある場合、コピーの作成は新しいスキームを追加するもっとも迅速な方法です。
- 新しいスキームを追加または既存のものをコピーして、編集リンクをクリックしてコピーした通知スキームの自動生成される名前および/または説明を編集する場合
- 通知スキームの名前を入力(または既存のものを編集)します(例:「アングリー ナードの通知スキーム」)
- (任意)通知スキームの説明を入力(または既存のものを編集)します。
- 追加ボタンをクリックして、通知スキームを作成します。
- 以下で説明されているように、通知/受信者を追加します。
- 以下で説明されているように、新しい通知スキームをプロジェクトに関連付けます。
通知スキームにイベントの受信者を追加する
通知スキームに特定のイベントの新しい受信者を追加するには、以下を実行します。
- 関連するプロジェクトで使用される通知スキームを特定します。
- この通知スキームの適切なイベントに受信者を追加します。
特定のイベントに新しい受信者を追加する方法:
- > [課題] を選択します。
- 通知スキームを選択して、Jira インストール内の現在のすべての通知スキームを一覧できる通知スキーム ページを開きます。
- 対象の通知スキームを探し、リンク名をクリックしてその通知スキームの「通知の編集」ページを開きます。
「通知の編集」ページには、すべてのイベントとともに、各イベントが発生したときに通知を受信する受信者が表示されます。 - 適切なイベント行の「追加」リンクをクリックし (以下のイベントを参照)、「通知の追加」ページを開きます。そこで、利用可能な受信者のリストから通知する (イベントに関する) 相手を選択できます (以下を参照)。
- 適切な受信者を選択します(受信者の特定の選択に必要な情報を入力します)。
- 追加ボタンをクリックします。通知の編集ページ(上記参照)に戻され、指定した通知が適切な課題イベントに対して一覧表示されます。
- 間違えてしまった場合や通知される人を除去したい場合、ユーザ/グループ/ロールのそばにある削除リンクをクリックします。
通知スキームとプロジェクトを関連付ける
- > [プロジェクト] を選択し、関連するプロジェクトを選択します。
- プロジェクト サマリ ページの右下にある通知セクションで、現在のスキームの名前(例:デフォルト通知スキーム)またはなし(プロジェクトがまだスキームに関連付けられていない場合)をクリックして、プロジェクトの現在の通知スキームの詳細を表示します。
- 「アクション」ドロップダウンメニューをクリックし、「別のスキームを使用」 (またはスキームを選択) を選択します。
- すべての利用可能な通知スキームが表示される、後続の通知スキームをプロジェクトに関連付けるページで、プロジェクトに関連付ける通知スキームを選択し、関連付けボタンをクリックします。
イベント
Jira アプリケーションは、電子メール通知を発生できる次のイベントをサポートします (通知スキームで定義したとおり)。
イベント | 説明 |
---|---|
課題が作成されました | 課題がプロジェクトに作られました。 |
課題が更新されました | 課題の詳細が変更されました。これには課題コメントの削除が含まれます。 |
課題が割り当てられました | 課題が新しいユーザに割り当てられました。 |
課題が解決しました | 課題が解決されました(通常、取り組みと修正が終わった後)。 |
課題が終了しました | 課題は終了しました。(課題は解決前に終了する場合がありますので注意してください。) |
課題にコメントが付けられました | 課題にコメントが追加されました。 |
課題のコメントが編集されました | 課題のコメントが編集されました。 |
課題が再開されました | 課題が再開されました。 |
課題が削除されました | 課題が削除されました。 |
課題が異動されました | 課題がこのプロジェクトに移動、またはこのプロジェクトから移動されました。 |
課題に作業が記録されました | 課題にログインした時間がありました(すなわち作業ログが追加されました)。 |
課題で作業を開始しました | 担当者が課題で作業を開始しました。 |
課題で作業が停止されました | 担当者が課題で作業を停止しました。 |
課題の作業ログが更新されました | 課題の作業ログのエントリが編集されました。 |
課題の作業ログが削除されました | 課題の作業ログのエントリが削除されました。 |
汎用イベント | このイベントの正確な性質は、このイベントを呼び出すワークフロー トランジションに依存します。 |
これらのイベントの正確な性質は、このイベントを呼び出すワークフロー トランジションに依存します。 |
Jira アプリケーションには、課題コメントの削除に対する特定の通知イベントはありません。課題のコメントが削除されると、JIRA は「課題が更新されました」イベントとして電子メール通知を送信します。
recipients
以下の種類の受信者がメール通知を受信できます。
受信者 | 説明 |
---|---|
現在の担当者 | 現在課題が割り当てられているユーザ。 |
報告者 | 課題を最初に作成したユーザ。 |
現在のユーザー | このイベントを開始する操作を実行したユーザ。 |
プロジェクトのリーダー | 課題が所属するプロジェクトを管理するユーザー 。 |
コンポーネントのリーダー | 課題が所属するコンポーネントを管理するユーザー 。 |
単一ユーザー | Jira システム内の特定のユーザー。 |
グループ | Jira システム内の特定のグループ。 |
プロジェクト ロール | The members of a particular project role for this project. |
シングル メール アドレス | Any email address that you wish to alert. |
すべてのウォッチャー | この課題をウォッチしているすべてのユーザー |
カスタムのフィールド値を使用する | The value of a custom field of type User Picker or Multi User Picker that may have been associated with issues. |
カスタムフィールド値のグループ化 | 課題と関連付けられている可能性のあるカスタムのフィールドタイプ「グループピッカー」または「マルチグループピッカー」の値。 |
注意:
- メール通知は、関連する課題を表示する権限を持つユーザにのみ送信されます — 該当ユーザは以下のとおりです。
- 課題が属するプロジェクトに対するプロジェクトの参照プロジェクト権限を持っている。かつ、
- その課題に割り当てられた課題セキュリティレベルのメンバーである。
- Jira は、SMTP 電子メールが有効化されている場合にのみ電子メール通知を送信できます (「電子メール通知の設定」を参照)。
- Jira の既定では、ユーザーにユーザー自身の変更を通知するよう設定されています。 この設定は、プロファイル設定からユーザーごとに変更できます。
注意:
担当者フィールドが変更されると、Jira は通知メールを前の担当者と現在の担当者の両方に送信します。
ただし、イベントの変更操作が課題の割り当てだった場合、Jira の以前のバージョンでは通知メールを前の担当者にのみ送信します。課題が他の方法で編集された場合、通知は送られません。
この挙動を希望する場合、Jira の詳細オプション jira.assignee.change.is.sent.to.both.parties
で有効化できます。
詳細については、「JRA-6344」を参照してください。