Work Management を Error Tracking と統合する
概要
Work Management を Error Tracking と統合して、Work Management の作業項目を作成し、Error Tracking の問題にリンクします。Work Management for Error Tracking を統合すると、以下のことができます。
- Error Tracking の問題パネルから直接 Work Management の作業項目を作成する
- 複数の Error Tracking の問題を 1 つの作業項目にグループ化する
- 自動化ルールを使用して、問題を特定の Work Management プロジェクトに自動的にルーティングする
- 特定の条件に一致する Error Tracking の問題に対応する Work Management の作業項目を自動的に作成する。
セットアップ
Error Tracking 用の Work Management 統合を使用するには、以下の 権限 が必要です。
- Error Tracking Read
- Error Tracking Issue Write
- Cases Read
- Cases Write
問題から作業項目を作成する
問題パネルから直接 Work Management の作業項目を作成し、その問題に関する調査作業をグループ化できます。
- Error Tracking エクスプローラー に移動します。
- 問題をクリックして、問題パネルを開きます。
- 問題パネルの [Actions] (アクション) ドロップダウンで、[Add Case] (ケースの追加) をクリックします。
- 作業項目を作成する Work Management プロジェクトを選択します。デフォルトでは、作業項目は Error Tracking プロジェクトに自動的に作成されます。
- [Create] (作成) をクリックして、作業項目を作成します。
作成後、作業項目は Error Tracking の問題にリンクされます。その後、作業項目のリンクが問題パネルに表示され、問題のステータスが自動的に[ REVIEWED] (レビュー済) に変更されます。
問題が作業項目にリンクされると、その状態、担当者、およびコメントが双方向に同期されます。
問題の状態と作業項目のステータスがどのように同期されるかについての詳細は、問題と作業項目間の状態の双方向同期を参照してください。
複数の問題を 1 つの作業項目にグループ化する
複数の Error Tracking の問題を 1 つの Work Management の作業項目に紐付けると、相関する問題を 1 つの作業単位にグループ化できます。
- Error Tracking エクスプローラー に移動します。
- 問題をクリックして、問題パネルを開きます。
- 問題パネルの [Actions] (アクション) ドロップダウンで、[Add Case] (ケースの追加) をクリックします。
- [Add to Existing Case] (既存ケースに追加) タブで、問題をグループ化する作業項目を選択します。
- 問題を作業項目にリンクするには、[Attach to Case] (ケースへの紐付け) をクリックします。
- このグループに追加するすべての問題で、これらの操作を繰り返します。
リンクされたすべての Error Tracking の問題は作業項目ビューに表示されるので、関連するエラーがまとめられて表示されます。
複数の問題が作業項目にリンクされると、それらの状態、担当者、およびコメントが双方向に同期されます。問題の状態と作業項目のステータスがどのように同期されるかについての詳細は、問題と作業項目間の状態の双方向同期を参照してください。
作業項目と問題の関係は 1:N の関係です。1 つの作業項目を複数の問題にリンクできますが、1 つの問題は 1 つの作業項目にのみリンクできます。
問題と作業項目間の状態の双方向同期
単一の Error Tracking の問題が単一の Work Management の作業項目にリンクされている場合
単一の Error Tracking の問題が単一の Work Management の作業項目にリンクされている場合、それらの状態は双方向に同期されます。問題の状態は以下のものにマッピングされます。
対応する作業項目のステータスグループのデフォルトステータス。
| Error Tracking の問題の状態 | Work Management のステータスグループ |
|---|
| [FOR REVIEW] (レビュー待) | [Open] (未解決) |
| [REVIEWED] | [In Progress] (進行中) |
| [RESOLVED] | [Closed] (終了) |
| [IGNORED] (無視) | [Closed] |
| [EXCLUDED] (除外済) | [Closed] |
複数の Error Tracking の問題が単一の Work Management の作業項目にリンクされている場合
複数の Error Tracking の問題が同じ Work Management の作業項目にリンクされている場合、状況に応じてそれらの状態間でも同期が行われます。
- 作業項目のステータスを更新すると、前の段落で説明した状態マッピングに従って、リンクされているすべての問題が更新されます。
- 問題の状態を更新すると、その結果として、リンクされている他の問題および作業項目の状態は次のルールに従ったものになります。
| 変更前の状態 | アクション | 変更後の状態 |
|---|
| ケースは [CLOSED] で、すべての問題が [RESOLVED]。 | 1 つの問題を [FOR REVIEW] に更新します。 | ケースは [OPEN] になりますが、他のすべての問題は [RESOLVED] のままです。 |
| ケースは [OPEN] で、すべての問題が [FOR REVIEW]。 | 1 つの問題を [RESOLVED] に更新します。 | ケースは [OPEN] のままで、1 つの問題が [RESOLVED] になりますが、他のすべての問題は [FOR REVIEW] のままです。 |
| ケースはCLOSEDで、別のリンクされていない 1 つのFOR REVIEWの問題がある。 | [FOR REVIEW] の問題を [CLOSED] のケースにリンクします。 | ケースは [CLOSED] のままで、すべての問題が [RESOLVED] になります (新しくリンクされた問題を含む)。 |
| ケースは [OPEN] で、別のリンクされていない [RESOLVED ] の問題が 1 つある。 | [RESOLVED] の問題を [OPEN] のケースにリンクします。 | ケースは [OPEN] のままで、新しく追加された問題を除くすべての問題は [FOR REVIEW] のままで、新しく追加された問題も [RESOLVED] のままです。 |
自動化ルール
特定の問題を Work Management プロジェクトに一致させるようにルールを設定できます。たとえば、問題がルールに一致すると、その問題に対して手動または自動で作成された作業項目は、そのルールで指定されたプロジェクトにデフォルトで割り当てられます。
セットアップ
Error Tracking の問題の自動化ルールを作成するには、以下の 権限 のいずれか 1 つが必要です。
- Error Tracking Write
- Error Tracking Settings Write
自動化ルールの作成
Work Management の自動化ルールを作成するには、次のようにします。
- Error Tracking Settings に移動し、[Ticketing & Automation] (チケット発行と自動化) セクションを開きます。
- [New Rule] (新規ルール) をクリックします。
- ルールを構成するには、次のようにします。
- [Match Criteria] (一致する条件): ルールをトリガーするために問題が満たすべき条件を定義します
- [Project] (プロジェクト): ルールに一致する問題から作成される作業項目の送信先の Work Management プロジェクトを選択します
- [Auto-create] (自動作成): 必要に応じて有効化し、問題が一致したときに作業項目が自動作成されるようにします
- [Save Rule] (ルールの保存) をクリックします。
一致条件
以下の属性に基づいてルールを構成します。
- [Service] (サービス): 特定のサービスからの問題を一致させます (例:
service:web-store) - [Team] (チーム): 問題のチームオーナーシップ に基づいて問題を一致させます (例:
team:Shopist)
複数の条件を組み合わせて、正確なルーティングルールを作成できます。問題一致クエリは、以下の演算子をサポートしています。
AND: 論理 AND (例: service:web-store AND team:Shopist)OR: 論理 OR (例: service:web-store OR team:Shopist)-: 論理 NOT (例: service:web-store -team:Shopist)
ルールには順序があります。課題に一致する最初のルールが適用されます。
作業項目の自動作成
自動化ルールを追加する際、ルールに一致する問題に対して作業項目の自動作成を有効にできます。
デフォルトでは、新しい Error Tracking 問題が作成されると、ルールが評価され、最初に一致したルールが適用されます。その一致したルールで作業項目自動作成が有効になっている場合、ルールで指定されたプロジェクト内に新しい Work Management 作業項目が作成され、一致した問題に紐付けられます。
参考資料