カスタム イベントの追加
Jira はイベントリスナー メカニズムを使用して、問題が発生したことをシステムに通知し、発生したイベントにもとづいて適切なアクション (メール通知の送信など) を実行します。Jira 内のすべての作業項目操作は特定のイベントに関連付けられています。たとえば、Work item created イベントは作業項目が作成されたときにトリガーされます。
Some events are fired by Jira internally, like a Work item updated or Work item moved event. Other events are fired from within workflow transition actions (previously post function), like a Work item resolved event, or a custom event.
Jira のイベントには2種類あります。
システム — システム イベントは終始 Jira 内部で使用され、追加や削除をすることができません。ただし、それらを非アクティブにすることはできます。
カスタム — カスタム イベントは、特定のワークフロー トランジションのアクションから、メール通知を生成 (またはリスナーの呼び出し) するのに使用されます。必要な分だけカスタム イベントを追加、削除することができます。非アクティブなカスタム イベントのみが削除可能ということに注意してください。
イベントは以下のいずれかのステータスになることができます。
アクティブ — イベントが少なくとも1つの通知スキームまたはワークフロー トランジションの事後操作に関連付けられています。
Inactive — the event is not associated with any notification schemes or workflow transition post functions. Note that the event state does not indicate whether the event is able to be fired. A custom event will only be fired if it is associated with a transition post function for an active workflow (go to Managing your workflows).
システム イベント
In system events, ‘issue’ refers to a work item. What is a work item?
Jira の組み込みイベント
課題が作成されました - 作業項目がシステムに入力されました。
課題が更新されました - 作業項目の詳細が変更されました。
課題が割り当てられました - 作業項目が新しいユーザーに割り当てられました。
課題が解決されました - 作業項目が解決されました (通常は作業と修正が終わった後)。
Issue closed - A work item has been closed. (Note that a work item may be closed without being resolved; see statuses).
課題にコメントが付きました - 作業項目にコメントが追加されました。
課題のコメントが編集されました - 作業項目のコメントが変更されました。
課題が再オープンされました - 作業項目が再度オープンされました。
課題が削除されました - 作業項目が削除されました。
課題が移動されました - 作業項目がこのスペースに移動されました。
課題の作業がログに記録されました - 作業項目に対する時間がログに記録されました (つまり作業ログが追加されました)。
課題の作業が開始されました - 担当者が作業項目の作業を開始しました。
課題で作業が停止されました - 担当者が作業項目の作業を停止しました。
課題の作業ログが更新されました - 作業項目の作業ログのエントリが変更されました。
課題の作業ログが削除されました - 作業項目の作業ログのエントリが削除されました。
Generic event - The exact nature of this event depends on the workflow transition post function(s) which invoke it. As with custom events, you can use the generic event to generate an email notification (or invoke a listener) from a particular workflow transition's post function (see Working with workflows).
カスタム イベント
カスタム ワークフローのカスタム トランジションの事後操作からカスタム イベントを発火することができます。このイベントの発火によって適切なリスナーがカスタム トランジションのアラートを受けます。例えば、カスタム イベントの発火に基づくワークフロー トランジションのユーザに通知するように関連する通知スキームを設定することができます。
カスタム イベントの通知の設定
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つの手順があります。
システムにカスタム イベントを追加します (例: 「QA 待ちの作業項目」)。
カスタム イベントの発生時にメールを送信するように通知スキームを設定します。
カスタム イベントを発生させるようにワークフロー トランジションの事後操作を設定します。
カスタムイベントを追加する
[設定] () を選択し、次に [システム] を選択します。
[詳細] > [イベント] の順に選択します。
ページ下部の新しいイベントの追加フォームに、カスタム イベントの名前と説明を追加します。
テンプレート フィールドで、デフォルトのメール テンプレートを選択し、イベントと関連付けます。
[追加] ボタンを選択します。
カスタム イベントはデフォルトのメール通知テンプレートと関連付ける必要があります。このイベントのユーザに通知するように設定された通知スキームは、通知の送信時にこのメール テンプレートを使用します。
カスタム イベントはシステムで定義されたイベントのリストに表示されます。最初、イベントは通知スキームやワークフローの事後操作と関連付けられていないため、非アクティブとしてマークされます。
メールを送信するように通知スキームを設定する
[設定] () を選択し、次に [システム] を選択します。
[ 詳細]、[ イベント] の順に選択します。
通知スキームの名前または [通知] リンク ([操作] の下) を選択して、編集する通知スキームを選択します。
Add the recipients for the custom event as required. See Creating a notification scheme for more information.
カスタム イベントを発生させるようにトランジション アクションを構成する
Jira 設定（）に移動し、作業項目、ワークフローの順に選択します。
編集するワークフローを見つけます。[アクション] 列で [その他] (...) > [編集] の順に選択します。
ワークフロー トランジションを選択します。
詳細パネルの [イベント] の下のドロップダウンからイベントを選択します。
[ワークフローを更新] を選択して変更を保存します。このワークフローを使用するすべてのスペースが更新されます。
If you’re using the old editor — make sure you activate the workflow and associate the workflow scheme to the relevant space. See Managing your workflows for more information.
この内容はお役に立ちましたか?