通知スキームを作成する
Jira アプリは、課題のライフサイクルを通じて発生するさまざまなイベント (カスタム イベントを含む) でメール通知を生成できます。通知は、特定のイベントと特定のメール受信者を関連付けた通知スキーム (以下を参照) で定義されます。その後、通知スキームは特定のプロジェクトに割り当てられます。
同じ通知スキームを複数のプロジェクトで使用できます。
既定の通知スキーム
Jira アプリには、既定の通知スキームと呼ばれる通知スキームが組み込まれています。
- このスキームは、初期設定ですべての新しいプロジェクトと関連付けられます。つまり、送信 (SMTP) メール サーバーのセットアップがある場合、新しいプロジェクトでアクティビティ (例: 課題の作成) が発生すると、メール通知がただちに送信されます。
- 以下で説明するように、[プロジェクト サマリー] ページでこの通知スキームの関連付けをプロジェクトから解除できます。
- このスキームを変更したり、特定のプロジェクトに対して他の通知スキームを作成することもできます。
通知スキームを管理する
次のすべての手順を行うには、Jira 管理者 グローバル権限 を持つユーザーとしてログインする必要があります。
通知スキームを作成する
- 画面右上で [管理
] > [課題] の順に選択します。
- サイドバーで [通知スキーム] を選択して、Jira インストール内の現在のすべての通知スキームを一覧できる "通知スキーム" ページを開きます。
- 次のいずれかを実行して、新しい通知スキームの作成を開始します：
- [コピー] リンクを選択して、既存の通知スキームをコピーします。必要なイベント受信者の設定に類似した通知スキームがある場合は、コピーを作成して新しいスキームを追加するのが最も簡単な方法です。
または - [通知スキームを追加] ボタンを選択します。"通知スキームを追加" ページで、通知スキームの名前とスキームの短い説明を入力します。
- [コピー] リンクを選択して、既存の通知スキームをコピーします。必要なイベント受信者の設定に類似した通知スキームがある場合は、コピーを作成して新しいスキームを追加するのが最も簡単な方法です。
- 新しい通知スキームを追加した場合、または、既存の通知スキームをコピーし、コピーした通知スキームに自動的に生成された名前や説明を変更するために [編集] をクリックした場合:
- 通知スキームの名前を入力 (または既存の名前を変更) します (例: "Angry nerds Nnotification scheme")。
- （任意）通知スキームの説明を入力（または既存のものを編集）します。
- [追加] ボタンを選択して、通知スキームを作成します。
- 以下で説明されているように、通知/受信者を追加します。
- 以下で説明されているように、新しい通知スキームをプロジェクトに関連付けます。
通知スキームにイベントの受信者を追加する
特定のイベントに新しい受信者を追加する方法：
- 画面右上で [管理] > [課題] の順に選択します。
- サイドバーで [通知スキーム] を選択して、Jira インストール内の現在のすべての通知スキームを一覧できる "通知スキーム" ページを開きます。
- 通知スキームを探し、リンク名をクリックしてその通知スキームの [通知の編集] ページを開きます。
[通知の編集] ページには、すべてのイベントとともに、各イベントが発生したときの通知の受信者が表示されます。 - 適切なイベント行の [追加] を選択して (以下のイベント リストを参照)、"通知を追加" ページを開きます。そこで、利用可能な受信者のリストから、イベントの通知先を選択できます (以下を参照)。
- 適切な受信者を選択します（受信者の特定の選択に必要な情報を入力します）。
- [追加] を選択します。通知の編集ページ（上記参照）に戻され、指定した通知が適切な課題イベントに対して一覧表示されます。
- 間違えてしまった場合や通知される人を除去したい場合、ユーザ/グループ/ロールのそばにある削除リンクをクリックします。
通知スキームとプロジェクトを関連付ける
- 画面右上で [管理] > [プロジェクト] の順に選択します。
- サイドバーで [通知] を選択して、現在のスキームの名前 (例: 既定の通知スキーム) または [なし] (プロジェクトがまだスキームに関連付けられていない場合) を選択して、プロジェクトの現在の通知スキームの詳細を表示します。
- [アクション] ドロップダウンを選び、[別のスキームを使用] (または [スキームを選択]) を選択します。
- すべての利用可能な通知スキームが表示される、後続の通知スキームをプロジェクトに関連付けるページで、プロジェクトに関連付ける通知スキームを選択し、関連付けボタンをクリックします。
イベント
Jira アプリケーションは、電子メール通知を発生できる次のイベントをサポートします (通知スキームで定義したとおり)。
各イベントは個別のメールで送信されますが、メール通知のバッチ処理を有効化して、類似イベントを 1 つの要約メールにまとめることができます。
イベント | 説明 |
|---|---|
課題が作成されました | 課題がプロジェクトに作られました。 |
課題が更新されました | 課題の詳細が変更されました。これには課題コメントの削除が含まれます。 |
課題が割り当てられました | 課題が新しいユーザに割り当てられました。 |
課題が解決しました | 課題が解決されました（通常、取り組みと修正が終わった後）。 |
課題が終了しました | 課題は終了しました。(課題は解決前に終了する場合がありますので注意してください。) |
課題にコメントが付けられました | 課題にコメントが追加されました。 |
課題のコメントが編集されました | 課題のコメントが編集されました。 |
課題が再開されました | 課題が再開されました。 |
課題が削除されました | 課題が削除されました。 |
課題が異動されました | 課題がこのプロジェクトに移動、またはこのプロジェクトから移動されました。 |
課題に作業が記録されました | 課題にログインした時間がありました（すなわち作業ログが追加されました）。 |
課題で作業を開始しました | 担当者が課題で作業を開始しました。 |
課題で作業が停止されました | 担当者が課題で作業を停止しました。 |
課題の作業ログが更新されました | 課題の作業ログのエントリが編集されました。 |
課題の作業ログが削除されました | 課題の作業ログのエントリが削除されました。 |
汎用イベント | このイベントの正確な性質は、このイベントを呼び出すワークフロー トランジションに依存します。 |
これらのイベントの正確な性質は、このイベントを呼び出すワークフロー トランジションに依存します。 |
Jira アプリには、課題コメントの削除に対する特定の通知イベントはありません。課題のコメントが削除されると、Jira は "課題の更新時" イベントとしてメール通知を送信します。
recipients
以下の種類の受信者がメール通知を受信できます。
受信者 | 説明 |
|---|---|
現在の担当者 | 現在課題が割り当てられているユーザ。 |
報告者 | 課題を最初に作成したユーザ。 |
現在のユーザー | このイベントを開始する操作を実行したユーザ。 |
プロジェクトのリーダー | 課題が所属するプロジェクトを管理するユーザー 。 |
コンポーネントのリーダー | 課題が所属するコンポーネントを管理するユーザー 。 |
単一ユーザー | Jira システム内の特定のユーザー。 |
グループ | Jira システム内の特定のグループ。 |
プロジェクト ロール | このプロジェクトの特定のプロジェクト ロールのメンバー。 システム内の通知スキームの数を最小限に抑えるためにも、通知ではグループではなく、プロジェクト ロールを使用することをお勧めします。 |
シングル メール アドレス | 警告の通知先のメール アドレス。 単一のメール アドレスへの通知は、課題が公開されている場合にのみ送信されます (セキュリティ チェックができない場合、非 Jira ユーザのメール アドレスも指定できます)。公開された課題とは、"プロジェクトの参照" 権限を "全員" (すべての非ログイン ユーザ) に与える権限スキームを持っている課題です。単一のメール アドレスへの通知にはテキスト テンプレートが使用されます。 |
すべてのウォッチャー | この課題をウォッチしているすべてのユーザー |
カスタムのフィールド値を使用する | 課題と関連付けられている "ユーザー ピッカー" または "マルチ ユーザー ピッカー" タイプのカスタム フィールドの値。 たとえば、"テスター" という名前のカスタム ユーザー フィールドがある場合、課題が解決されたときにテスターに通知することができます。 |
カスタムフィールド値のグループ化 | 課題と関連付けられている可能性のあるカスタムのフィールドタイプ「グループピッカー」または「マルチグループピッカー」の値。 |
次をご検討ください。
- メール通知は、関連する課題を表示する権限を持つユーザにのみ送信されます — 該当ユーザは以下のとおりです。
- 課題が属するプロジェクトに対するプロジェクトの参照プロジェクト権限を持っている。かつ、
- その課題に割り当てられた課題セキュリティレベルのメンバーである。
- Jira は、SMTP 電子メールが有効化されている場合にのみ電子メール通知を送信できます (「電子メール通知の設定」を参照)。
- Jira の既定では、ユーザーにユーザー自身の変更を通知するよう設定されています。 この設定は、プロファイル設定からユーザーごとに変更できます。
- 各イベントは個別のメールで送信されますが、メール通知のバッチ処理を有効化して、類似イベントを 1 つの要約メールにまとめることができます。
担当者フィールドが変更されると、Jira は通知メールを前の担当者と現在の担当者の両方に送信します。
しかし、以前のバージョンの Jira では、イベントを変更した操作が "課題の割り当て" 操作である場合に限って、前の担当者に通知メールが送信されていました。課題が他の方法で編集された場合、通知は送信されませんでした。
この動作をご希望の場合は、Jira の高度なオプション jira.assignee.change.is.sent.to.both.parties で有効化できます。
詳細は「JRA-6344」をご参照ください。