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

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

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

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

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

Note

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

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

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

前提条件

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

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

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

Note

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

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

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

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

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

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

Note

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

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

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

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

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

Note

インターネット エクスプローラーは、Azure DevOps Services でも Azure DevOps Server 2020.1 でもサポートされなくなりました。

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

ほとんどのグラフでは、データの並べ替え方法を選択できます。 [値] または [ラベル] で並べ替え、[昇順] または [降順] を選択できます。

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

シリーズの限定表示

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

グラフの可用性

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

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

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

   

   関係者アクセス権がある場合、[グラフ] リンクと [新しいグラフ] リンクは表示されません。

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

   

   [グループ化] ドロップダウン リストに目的のフィールドが表示されない場合は、フィールドを列としてクエリに追加し、クエリを保存します。 また、[集計] オプションは、クエリで使用されるフィールドまたは [列のオプション] から選択したフィールドによって異なります。

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

3. 結果を並べ替えるには、並べ替えオプションとして [値] または [ラベル] を選択し、[昇順] または [降順] を選択します。

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

   

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

円グラフを追加する

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

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

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

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

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

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

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

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

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

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

傾向グラフを追加する

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

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

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

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

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

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

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

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

ヒント

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

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

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

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

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

関連記事

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