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

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. Select Settings (), then System.

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.

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

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

Now that you have your custom event created, you need to map it to a notification scheme. Notification schemes allow you to reuse your configurations across multiple spaces.

1. Select Settings (), then Work items.

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. Select Settings (), then Work items.

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

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

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

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

6. In the table showing the transition's post functions, locate the Fire a… post function. Select the pencil icon to edit the post function.

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

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

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

You did it! Now, any space that uses this workflow will get your custom email event notification on the transition you elected.