カスタム イベントのメール通知を構成する

JIRA 管理者は、カスタム ワークフローのトランジションのメール 通知をトリガーする、カスタム イベントを設定できます。

Custom events are most commonly used to generate notifications for custom workflow transitions. For example, your organization might need you to modify the default workflow by adding a workflow step called QA_Inspection (e.g. between Resolve Work Item and Close Work Item). You would typically also need to generate an email notification to the QA team whenever a work item progresses to the QA_Inspection step of the workflow.

これを実現するために3つの手順があります。

1. Add a custom event to the system (e.g. Work Item Awaiting QA).

2. カスタム イベントの発生時にメールを送信するように通知スキームを設定します。

3. カスタム イベントを発生させるようにワークフロー トランジションの事後操作を設定します。

カスタム イベントの追加

まず、カスタム イベントを作成する必要があります。このイベントをあとから使用してメールをトリガーします。カスタム イベントを追加するには、次の手順を実行します。

1. [設定] ( を選択します。[) > [システム]

2. サイドバーで、[詳細] の [イベント] をクリックします。

3. [新しいイベントの追加] セクションで、カスタム イベントの名前と説明を追加します。

4. [テンプレート]ドロップダウンで、[Generic event] を選択します。

5. 追加をクリックします。

The custom event must be associated with the generic event email template. A notification scheme configured to notify users of this event will use this email template when sending the notification. It looks very similar to the “Work item updated” event email.

カスタム イベントはシステムで定義されたイベントのリストに表示されます。最初、イベントは通知スキームやワークフローの事後操作と関連付けられていないため、非アクティブとしてマークされます。

メールを送信するように通知スキームを設定する

カスタム イベントを作成したら、それを通知スキームにマッピングする必要があります。通知スキームを使用することで、複数のプロジェクトで設定を再利用できます。通知スキームの詳細をご確認ください。

1. [設定] () > [作業項目] の順に選択します。

2. In the sidebar, under WORK ITEM ATTRIBUTES, select Notification schemes.

3. 通知スキーム名をクリックして、編集する通知スキームを選択します。または、新規スキームを作成します。

4. イベント名の横にある [操作] 列の [追加] リンクを選択して、カスタム イベントをスキームに追加します。カスタム イベントが一覧の一番下に表示されます。

5. 必要に応じてカスタム イベントの受信者を追加し、[追加] を選択します。

これで通知スキームをカスタム イベントに含めることができました。ただし引き続き、イベントをワークフローに追加して、メールを送信するタイミングを Jira に指定する必要があります。

ワークフローでカスタム イベントをトリガーするように事後操作を設定する

Post functions allow you to automate some actions when people transition work items down their workflow. In this case, we want to use a post function to tell Jira when you want your custom email event to fire, or what transition should trigger the email event.

1. [設定] () > [作業項目] の順に選択します。

2. サイドバーの [ワークフロー] で [ワークフロー] をクリックします。

3. イベントを追加するワークフローを見つけて、[編集] を選択します。

4. ワークフローのダイアグラムを表示して、カスタム メール イベントを開始するトランジションを選択します。

5. トランジションの詳細を表示して、[オプション] の [事後操作] を選択します。

6. トランジションの事後操作を示す表で、[...イベントを発生させます。]事後操作を見つけます。鉛筆アイコン ([編集]) を選択して、事後操作を編集します。

7. [イベント] ドロップダウン メニューで、このトランジションで開始したいカスタム イベントを選択します。

8. [アップデート] を選択します。

9. [下書きの公開] を選択して、ワークフローへの変更内容を公開します。

これで設定が完了しました。今後、このワークフローを使用するすべてのプロジェクトで、選択したトランジションについてカスタム イベントの通知が送信されます。