カスタム イベントの追加
Jira はイベントリスナー メカニズムを使用して、問題が発生したことをシステムに通知し、発生したイベントにもとづいて適切なアクション (メール通知の送信など) を実行します。Jira 内のすべての作業項目操作は特定のイベントに関連付けられています。たとえば、Work item created イベントは作業項目が作成されたときにトリガーされます。
一部のイベント (例: Work item updated、Work item moved イベントなど) は Jira 内部でトリガーされます。また、ワークフロー トランジションのアクション内 (旧名称は「事後操作」) でトリガーされるイベントもあります。例: Work item resolved イベント、カスタム イベント。
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).
システム イベント
システム イベントでは、「課題」は作業項目を指します。作業項目とは
Jira の組み込みイベント
課題が作成されました - 作業項目がシステムに入力されました。
課題が更新されました - 作業項目の詳細が変更されました。
課題が割り当てられました - 作業項目が新しいユーザーに割り当てられました。
Issue resolved - A work item has been resolved (usually after being worked on and fixed).
Issue closed - A work item has been closed. (Note that a work item may be closed without being resolved; see statuses).
課題にコメントが付きました - 作業項目にコメントが追加されました。
課題のコメントが編集されました - 作業項目のコメントが変更されました。
課題が再オープンされました - 作業項目が再度オープンされました。
Issue deleted - A work item has been deleted.
Issue moved - A work item has been moved into this space.
Work logged on issue - A work item has had hours logged against it (i.e. a worklog has been added).
課題の作業が開始されました - 担当者が作業項目の作業を開始しました。
課題で作業が停止されました - 担当者が作業項目の作業を停止しました。
課題の作業ログが更新されました - 作業項目の作業ログのエントリが変更されました。
課題の作業ログが削除されました - 作業項目の作業ログのエントリが削除されました。
汎用イベント - このイベントの本質は、このイベントを呼び出すワークフロー トランジションの事後操作によって異なります。カスタム イベントと同様に、汎用イベントによって特定のワークフロー トランジションの事後操作からメール通知を生成 (またはリスナーを呼び出し) できます (「ワークフローで作業する」参照)。
カスタム イベント
カスタム ワークフローのカスタム トランジションの事後操作からカスタム イベントを発火することができます。このイベントの発火によって適切なリスナーがカスタム トランジションのアラートを受けます。例えば、カスタム イベントの発火に基づくワークフロー トランジションのユーザに通知するように関連する通知スキームを設定することができます。
カスタム イベントの通知の設定
カスタム イベントはほとんどの場合、カスタム ワークフロー トランジションの通知の生成に使用されます。たとえば、自分の組織が「QA_検証」というワークフロー ステップを追加するように既定のワークフローの変更を必要とするとします (例: 作業項目の解決と作業項目のクローズの間)。また、通常、作業項目がワークフローの「QA_検証」ステップに進むたびに QA チームへのメール通知を生成する必要があります。
これを実現するために3つの手順があります。
システムにカスタム イベントを追加します (例: 「QA 待ちの作業項目」)。
カスタム イベントの発生時にメールを送信するように通知スキームを設定します。
カスタム イベントを発生させるようにワークフロー トランジションの事後操作を設定します。
カスタムイベントを追加する
Select Settings (), then System.
[詳細] > [イベント] の順に選択します。
ページ下部の新しいイベントの追加フォームに、カスタム イベントの名前と説明を追加します。
テンプレート フィールドで、デフォルトのメール テンプレートを選択し、イベントと関連付けます。
[追加] ボタンを選択します。
カスタム イベントはデフォルトのメール通知テンプレートと関連付ける必要があります。このイベントのユーザに通知するように設定された通知スキームは、通知の送信時にこのメール テンプレートを使用します。
カスタム イベントはシステムで定義されたイベントのリストに表示されます。最初、イベントは通知スキームやワークフローの事後操作と関連付けられていないため、非アクティブとしてマークされます。
メールを送信するように通知スキームを設定する
Select Settings (), then System.
Select Advanced, then Events.
通知スキームの名前または [通知] リンク ([操作] の下) を選択して、編集する通知スキームを選択します。
必要に応じてカスタム イベントの受信者を追加します。詳細については、「通知スキームの作成」を参照してください。
カスタム イベントを発生させるようにトランジション アクションを構成する
Go to Jira settings (), then select Work items and then Workflows.
編集するワークフローを見つけます。[アクション] 列で [その他] (...) > [編集] の順に選択します。
ワークフロー トランジションを選択します。
Select an event from the dropdown under EVENT in the details panel.
[ワークフローを更新] を選択して変更を保存します。このワークフローを使用するすべてのスペースが更新されます。
古いエディターを使用している場合、必ずワークフローを有効化して、ワークフロー スキームを関連するスペースに関連付けてください。詳細については、「ワークフローを管理する」を参照してください。
この内容はお役に立ちましたか?