カスタム イベントの追加
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つの通知スキームまたはワークフロー トランジションの事後操作に関連付けられています。
非アクティブ — イベントはいずれの通知スキームまたはワークフロー トランジションの事後操作にも関連付けられていません。イベントの状態は、イベントを発生可能かどうかを示すものではないことに注意してください。カスタム イベントは、アクティブなワークフローのトランジション事後操作に関連付けられている場合にのみ発生します (「ワークフローの管理」を参照)。
システム イベント
システム イベントでは、「課題」は作業項目を指します。作業項目とは？
Jira の組み込みイベント
課題が作成されました - 作業項目がシステムに入力されました。
課題が更新されました - 作業項目の詳細が変更されました。
課題が割り当てられました - 作業項目が新しいユーザーに割り当てられました。
課題が解決されました - 作業項目が解決されました (通常は作業と修正が終わった後)。
課題がクローズされました - 作業項目がクローズされました。(作業項目は解決前に終了する場合があります。 「ステータス」参照)。
課題にコメントが付きました - 作業項目にコメントが追加されました。
課題のコメントが編集されました - 作業項目のコメントが変更されました。
課題が再オープンされました - 作業項目が再度オープンされました。
課題が削除されました - 作業項目が削除されました。
課題が移動されました - 作業項目がこのスペースに移動されました。
課題の作業がログに記録されました - 作業項目に対する時間がログに記録されました (つまり作業ログが追加されました)。
課題の作業が開始されました - 担当者が作業項目の作業を開始しました。
課題で作業が停止されました - 担当者が作業項目の作業を停止しました。
課題の作業ログが更新されました - 作業項目の作業ログのエントリが変更されました。
課題の作業ログが削除されました - 作業項目の作業ログのエントリが削除されました。
汎用イベント - このイベントの本質は、このイベントを呼び出すワークフロー トランジションの事後操作によって異なります。カスタム イベントと同様に、汎用イベントによって特定のワークフロー トランジションの事後操作からメール通知を生成 (またはリスナーを呼び出し) できます (「ワークフローで作業する」参照)。
カスタム イベント
カスタム ワークフローのカスタム トランジションの事後操作からカスタム イベントを発火することができます。このイベントの発火によって適切なリスナーがカスタム トランジションのアラートを受けます。例えば、カスタム イベントの発火に基づくワークフロー トランジションのユーザに通知するように関連する通知スキームを設定することができます。
カスタム イベントの通知の設定
カスタム イベントはほとんどの場合、カスタム ワークフロー トランジションの通知の生成に使用されます。たとえば、自分の組織が「QA_検証」というワークフロー ステップを追加するように既定のワークフローの変更を必要とするとします (例: 作業項目の解決と作業項目のクローズの間)。また、通常、作業項目がワークフローの「QA_検証」ステップに進むたびに QA チームへのメール通知を生成する必要があります。
これを実現するために3つの手順があります。
システムにカスタム イベントを追加します (例: 「QA 待ちの作業項目」)。
カスタム イベントの発生時にメールを送信するように通知スキームを設定します。
カスタム イベントを発生させるようにワークフロー トランジションの事後操作を設定します。
カスタムイベントを追加する
[設定] () を選択し、次に [システム] を選択します。
[詳細] > [イベント] の順に選択します。
ページ下部の新しいイベントの追加フォームに、カスタム イベントの名前と説明を追加します。
テンプレート フィールドで、デフォルトのメール テンプレートを選択し、イベントと関連付けます。
[追加] ボタンを選択します。
カスタム イベントはデフォルトのメール通知テンプレートと関連付ける必要があります。このイベントのユーザに通知するように設定された通知スキームは、通知の送信時にこのメール テンプレートを使用します。
カスタム イベントはシステムで定義されたイベントのリストに表示されます。最初、イベントは通知スキームやワークフローの事後操作と関連付けられていないため、非アクティブとしてマークされます。
メールを送信するように通知スキームを設定する
[設定] () を選択し、次に [システム] を選択します。
[ 詳細]、[ イベント] の順に選択します。
通知スキームの名前または [通知] リンク ([操作] の下) を選択して、編集する通知スキームを選択します。
必要に応じてカスタム イベントの受信者を追加します。詳細については、「通知スキームの作成」を参照してください。
カスタム イベントを発生させるようにトランジション アクションを構成する
Jira 設定（）に移動し、作業項目、ワークフローの順に選択します。
編集するワークフローを見つけます。[アクション] 列で [その他] (...) > [編集] の順に選択します。
ワークフロー トランジションを選択します。
詳細パネルの [イベント] の下のドロップダウンからイベントを選択します。
[ワークフローを更新] を選択して変更を保存します。このワークフローを使用するすべてのスペースが更新されます。
古いエディターを使用している場合、必ずワークフローを有効化して、ワークフロー スキームを関連するスペースに関連付けてください。詳細については、「ワークフローを管理する」を参照してください。
この内容はお役に立ちましたか?