状態と傾向のクエリベースのグラフを使用して進行状況を追跡する

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

フラット リスト クエリの結果をグラフ化することで、進行中の作業の状態をすばやく表示できます。 円、列、ピボット、傾向などのさまざまなグラフ ビューがサポートされています。 グラフでは、作業項目の数または選択した数値フィールドの値の合計 (ストーリー ポイント、作業量、残存作業時間など) の表示がサポートされます。 状態、割り当て先、またはその他のシステム定義フィールドまたはユーザー設定フィールドで作業をグループ化します。

この記事では、次のタスクを実行する方法について説明します。

• グラフをサポートするフラット リスト クエリを作成する
• クエリベースのグラフを作成して共有する
• ステータス 円グラフ、縦棒グラフ、横棒グラフ、ピボット グラフを作成する
• 傾向グラフを作成する
• ダッシュボードにグラフを追加する

Note

この記事では、作業追跡クエリ グラフを構成する方法について説明します。 既存のクエリ グラフをダッシュボードに追加するには、「 ダッシュボードにグラフを追加するを参照してください。 作業項目のグラフウィジェットの構成については、「作業項目ウィジェットのグラフを構成する」を参照してください。

すべての作業追跡グラフとコンテキスト内レポートの概要については、「 ダッシュボード、グラフ、レポート、ウィジェットについてを参照してください。

たとえば、次の図は、同じフラット リスト クエリから作成された 2 つの異なるグラフを示しています。 円グラフは 19 個のバグを状態別にグループ化し、横棒グラフは割り当てとその現在の状態別にバグをグループ化します。

前提条件

満たす前提条件には、 Basic 以上のアクセス権を持っていること、およびフラット リスト クエリを作成することが含まれます。 グラフをサポートするのは、フラット リスト クエリのみです。

グラフをダッシュボードに追加する場合は、クエリを Shared Queries フォルダーに保存し、グラフを追加するダッシュボードを作成する必要があります。

• クエリ グラフを作成するには、 Basic 以上のアクセス権が必要です。 利害関係者アクセスを持つユーザーは、[クエリ] ページからグラフを表示または作成することはできませんが、チーム ダッシュボードに追加されたグラフを表示することはできます。 詳細については、「利害関係者アクセスのクイック リファレンス」を参照してください。
• グラフをダッシュボードに追加するには、クエリを Shared Queries フォルダーに保存する必要があります。 そのためには、クエリをフォルダーの下に保存するためのアクセス許可が付与されている必要があります。 アクセス許可の付与については、クエリとクエリ フォルダーに対するアクセス許可の設定に関する記事を参照してください。
• チーム ダッシュボードにクエリ グラフを追加するには、チームのメンバーであるか、 Project Administrators セキュリティ グループのメンバーである必要があります。
• プロジェクト ダッシュボードにクエリ グラフを追加するには、ダッシュボードを作成しているか、ダッシュボードを編集するためのアクセス許可が付与されているか、 Project Administrators セキュリティ グループのメンバーである必要があります。
• ダッシュボードに追加されたクエリ グラフを表示するには、基となるクエリに対する読み取りアクセス許可が必要です。 そのアクセス許可が拒否された場合、ウィジェットは Widget が読み込めませんでした メッセージと共に表示されます。

Note

パブリック プロジェクトの利害関係者アクセスを持つユーザーは、基本アクセスを持つユーザーと同様に、クエリ グラフの機能にフル アクセスできます。 詳細については、「利害関係者アクセスのクイック リファレンス」を参照してください。

ダッシュボードのアクセス許可の詳細については、「 ダッシュボードのアクセス許可の設定」を参照してください。

フラット リスト クエリを作成する

グラフをサポートするクエリを作成する場合は、次のガイドラインに従ってください。

• 常に 作業項目の一覧 クエリの種類を選択します。 グラフ作成では、その他のクエリの種類はサポートされていません。 詳細については、「 クエリの定義」、「フラット リスト クエリの定義」を参照してください。
• これらのフィールドを、グラフ内で使用するクエリ句または列オプションに追加します。 日付-時刻、自由形式のテキスト、タグ フィールドを除く任意のフィールドでグラフをグループ化できます。 例:
  • Status でグループ化するには、 State フィールドを含めます。
  • 作業の割り当てでグループ化するには、[割り当て先] フィールドを含めます
  • スプリントやイテレーションでグループ化するには、[イテレーション パス] を含めます
  • チーム別にグループ化するには、エリア パスのリーフ ノードを表示する Node Name フィールドを含めます。
  • カスタム フィールドでグループ化するには、それを含めます。
• 数値列を合計するには、クエリ句または列オプションに対応するフィールドを含めます。 数値フィールドから作成されるグラフのその他の例については、数値フィールドによるクエリに関する記事を参照してください。
• クエリをダッシュボードに追加する予定の場合は、クエリを Shared クエリとして保存。

• 次のフィールド データ型でグラフをグループ化することはできません。
  • ID
  • 作成日、変更日など、日付と時刻
  • タイトルなどのプレーン テキスト
  • 説明、再現手順などのリッチ テキスト
  • タグ (タグを使用してクエリをフィルター処理できますが、タグを使用してグラフを構成することはできません)。

Note

クエリベースのグラフをタグ別にグループ化することはできませんが、「 作業項目のグラフを構成する ウィジェットをダッシュボードに追加するタグ別にグループ化 作業項目ウィジェットのグラフを構成する。

領域とイテレーションの表示

A パスまたは Iteration Path を選択すると、リーフ ノードのみがグラフに表示されます。 リーフ ノードはフル パスの最後のノードです。 たとえば、 Phone は FabrikamFiber/Fabrikam Website/Phoneのリーフ ノードです。 クエリに混合レベルのリーフ ノードが含まれている場合、グラフに予期した結果が反映されない可能性があります。

ノード名フィールド(エリア パス リーフ ノード)を選択して、結果が向上するかどうかを確認します。

スケーラブル ベクター グラフィックス (SVG) をサポートするブラウザーにグラフが表示されます。 サポートされているブラウザーには、Microsoft Edge、Internet Explorer 9 以降のバージョン、Chrome、Firefox、Safari on Mac が含まれます。 グラフは、モバイルディスプレイやタッチディスプレイ用に最適化されていません。

Note

Internet Explorer は、Azure DevOps Services でも Azure DevOps Server 2020.1 でもサポートされなくなりました。

値またはラベルで並べ替え

ほとんどのグラフでは、データの並べ替え方法を選択できます。 Value または Label で並べ替え、Ascending または Descending を選択できます。

• 値: 数値でデータを並べ替えます
• ラベル: データをグループ化するために選択したラベルで並べ替えます。

シリーズの限定表示

グラフにデータ系列内に 8 個または 12 個を超える項目が含まれている場合、9 または 13 プラス項目の値が "other" というラベルの付いたセットに統合されますか? ただし、ダッシュボードの構成可能なウィジェットを使用してグラフのサイズを大きくすると、系列の制限が増える可能性があります。

グラフの可用性

• 共有クエリに保存されたグラフは、Stakeholder アクセス権を持つメンバーを除くすべてのチーム メンバーが表示でき、ダッシュボードに追加できます。
• "マイ クエリ" フォルダーにあるクエリから作成したグラフは、他のユーザーには表示されません。
• グラフ ページの URL をコピーしてメールで送信することで、プロジェクト メンバーと共有できます。
• テスト用の同様のグラフを作成するには、「 Track テストの状態」を参照してください。

クエリベースのグラフを作成する

1. Queries から、フラット リスト クエリのグラフ エディターを開きます。 グラフを作成するには、[共同作成者] グループに属している必要があります。

   

   Stakeholder アクセス権を持っている場合、Charts および New Chart リンクは表示されません。

2. 値をグループ化するグラフの種類とフィールドを選択します。 円グラフ、横棒グラフ、縦棒グラフを使用する場合は、1 つのフィールドを選択して作業項目の数を表示します。

   

   Group by ドロップダウン リストに必要なフィールドが表示されない場合は、フィールドを列としてクエリに追加、クエリを保存します。 また、 Aggregation オプションは、クエリで使用されるフィールド、または Column Options から選択されたフィールドによって異なります。

   グラフ エディターを閉じるときにエラー メッセージが表示される場合は、 Basic アクセスを要求する必要があります。

3. 結果を並べ替えるには、並べ替えオプションとして Value または Label を選択し Ascending または Descending。

   色を変更するには、カラー ピッカーの系列セットから色を選択します。

   

グラフは、クエリの編集またはクエリ結果の更新時に自動的に更新されます。

円グラフを追加する

円グラフを使用して、6 つ以下のカテゴリを持つグループの割合を表示します。 円グラフの良い例を次に示します。

• アクティブなバグの状態、状態別のグループ化
• ユーザー ストーリーの状態、状態別のグループ化
• ユーザー ストーリーの進行状況、完了、進行中、または切り取りでグループ化

たとえば、次のクエリでは、年の初めから切り取り、進行中、完了の状態に基づいてユーザー ストーリーをフィルター処理します。

円グラフの構成は、次の図のようになります。

クエリとグラフの構成を組み合わせると、次の円グラフが生成されます。

積み上げ横棒グラフを追加する

積み上げ横棒グラフを使用すると、2 つのフィールド値に対する進行状況を追跡できます。 ノード名には、エリア パス内の最後のリーフが表示されます。 これは、チーム間でデータを表示し、各ノードがチームに対応する場合に使用します。

ピボット テーブルを追加する

ピボット テーブルには、構成可能な行と列のテーブルが表示され、列には作業項目の数または数値フィールドの合計が表示されます。 作業が実行されている領域間で比較する場合は、ピボット テーブルを選択します。

次の図は、開発者に割り当てられたアクティブなバグとその現在の状態の例を示しています。

傾向グラフを追加する

傾向グラフを使用すると、時間の経過に伴う進行状況を表示できます。 最後の週から最後の年までのローリング期間を選択できます。

傾向データは、作業追跡データ ストアから抽出されます。 ほとんどのデータ ストアと同様に、リレーショナル データベースのスキーマは、データのオンライン トランザクション処理用に設計および最適化されています。 ツールまたはプラグインがアクティビティを実行すると、操作ストアに最新の情報が書き込まれます。 そのため、運用ストア内のデータは常に変更され、更新され、すべてのデータが最新の状態になります。

バーンダウン グラフを追加する

バーンダウン グラフは、ストーリー ポイント、作業量、残存作業時間などの数値フィールド値、または作業項目の数に基づいて、作業の進行状況を判断するのに役立ちます。

バーンダウン グラフを作成するには、クエリに必要な数値フィールドを必ず追加してください。 タスクのバーンダウン グラフを表示するには、Remaining Work の Sum 演算子を選択します。

クエリベースのバーンダウン グラフに加えて、バーンダウンまたはバーンアップ ウィジェットの構成。

ダッシュボードにグラフを追加する

ダッシュボードに追加されたグラフは、 Chart for Work Items ウィジェットを追加して追加されます。 次の手順に示すように、グラフをダッシュボードに追加することも、 Chart for Work Items ウィジェットを直接追加することもできます。 詳細については、「 作業項目ウィジェットのグラフを構成する」を参照してください。

ヒント

すべてのクエリ グラフのサイズは制限されています。 ただし、ダッシュボードに追加されたグラフは、表示に使用する Chart for Work Items ウィジェットを開くことで、サイズを調整したり、再構成したりできます。

• 追加するグラフの アクション アイコンを選択し、 ダッシュボードに追加を選択します。

ダッシュボードに追加 メニュー オプションは、Shared Queries フォルダーに保存されているクエリでのみ使用できます。

開いたダイアログで、グラフを追加するダッシュボードを選択します。

テスト結果やビルドの概要グラフなど、他の種類のグラフを追加するには、「 ウィジェットとグラフをダッシュボードに追加する」を参照してください。

関連記事

• クエリ グラフの例
• 作業項目ウィジェットのグラフを構成する
• Azure DevOps ダッシュボード、グラフ、レポートに関する FAQ
• 累積フロー ダイアグラム
• チームのベロシティ
• スプリント バーンダウンの表示/構成
• テストの状態の追跡
• ウィジェットとグラフをダッシュボードに追加する
• ウィジェット カタログ