Azure Boards と Azure DevOps の数値フィールドによるクエリの実行
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
チーム内の各開発者が完了した作業量を確認するにはどうすればよいですか? イテレーションごとの作業量やストーリー ポイントを合計する方法はありますか?
最も一般的な数値フィールドは、要件カテゴリの項目の作業量や、タスク カテゴリの項目の見積もり、残存、完了の作業を追跡します。 クエリを使うと、対象の作業項目を一覧表示し、作業項目の数または数値フィールドの合計を示すグラフを定義することができます。
サポートされている演算子とマクロ
数値フィールドを指定するクエリ句では、次に示す演算子を使用できます。
- = , <> , > , < , >= , <=
- =[フィールド], <>[フィールド], >[フィールド], <[フィールド], >=[フィールド], <=[フィールド]
- In、Not In
- 次の値と等しかったことがある
グラフベースのクエリを開発するためのヒント
- グラフを追加できるのは、単純なリストのクエリのみです
- グラフのオプションは、クエリ フィルターまたは列オプションで表示されるフィールドのいずれかを参照します
- グラフを追加または変更する前に、クエリに加えた変更を保存します。
- 1 つ以上の句をグループ化するには、それらを選び、
句のグループ化アイコンを選びます。 グループ化を解除するには、グループ化された句を選びます。
クエリとグラフベースのクエリの作成の詳細については、クエリ エディターを使ったクエリの一覧と管理とグラフに関する記事を参照してください。 カスタム フィールドを追加して、他の数値を追跡して合計を生成する場合は、フィールドの追加および変更に関する記事を参照してください。
便利なフィルター
フィルターの対象
含まれるクエリ句
ユーザー ストーリーまたはバグ
Work Item Type In User Story,Bug
タスクまたはバグ
Work Item Type In Task,Bug
アクティブまたはクローズの項目
State In Active,Closed
要件カテゴリの項目
Work Item Type In Group Microsoft.RequirementCategory
未評価のユーザー ストーリー
Story Points <> (leave Value field blank)
作業項目数のクエリとグラフ
クエリを実行すると、すべてのクエリで項目の数が表示されます。 ここでは、任意の状態のバグをフィルター処理する単純なリストのクエリを定義します。
また、すべてのグラフには、グラフ内の作業項目の数を表示するように設計された値の選択が含まれています。
開発者ごとのバグ数
アクティブなバグのクエリを作成し、列のオプションを変更して [割り当て先] と [状態] を表示します。 次に、割り当てと状態を表示するピボット グラフを追加します。
![[グラフの構成] ダイアログ、割り当て先と状態によるピボット](media/numeric/config-pivot-items-developer.png?view=azure-devops)
状態と区分別のバグの数
前のセクションで示したバグをフィルター処理するのと同じ単純なリストのクエリを使って、区分に基づいた数を表示できます。 列のオプションを変更して、区分パスを表示します。 次に、状態と区分パスを表示するピボット グラフを追加します。
![[グラフの構成] ダイアログ、状態と区分によるピボット](media/numeric/config-pivot-state-area.png?view=azure-devops)
未定義フィールド値のクエリ
等号演算子 (=) を使い、フィールドの値を空白にすることで、未定義のフィールド値を持つ作業項目を見つけることができます。 たとえば、次のフィルターでは、[ストーリー ポイント] フィールドが空白のユーザー ストーリー型のすべての作業項目が一覧表示されます。
空白でないフィールドに基づいて作業項目を一覧表示するには、not 演算子 (<>) を使い、値を空白のままにします。
作業量やストーリー ポイントのクエリとグラフ
アジャイル プロセスで作業する場合、ユーザー ストーリーやバグにストーリー ポイントを割り当てることができます。 また、スクラム プロセスで作業する場合は、プロダクト バックログ項目とバグに作業量を割り当てることができます。 詳細については、基本、アジャイル、スクラム、または CMMI 作業項目の種類とワークフローに関する記事を参照してください。
ストーリー ポイントとその状態の合計
作業項目の種類としてユーザー ストーリーをフィルター処理するクエリを作成し、ストーリー ポイントと状態を表示するように列オプションを変更します。
次に、ストーリー ポイントを合計する積み上げ横棒グラフを追加します。
![[グラフの構成] ダイアログ、積み上げ横棒、ストーリー ポイントの合計](media/numeric/config-psum-story-points-stacked-bar.png?view=azure-devops)
システム定義の累積フロー ダイアグラムの詳細については、累積フローに関する記事を参照してください。
イテレーションごとのユーザー ストーリーのバーンアップ グラフ
作業項目の種類としてユーザー ストーリーをアクティブまたはクローズ状態でフィルター処理するクエリを作成します。 ストーリー ポイントを表示するように列のオプションを変更します。
次に、ストーリー ポイントを合計する積み上げ面トレンド グラフを追加します。
![[グラフの構成] ダイアログ、トレンド、ストーリー ポイントの合計](media/numeric/config-trend-sum-story-points.png?view=azure-devops)
残存作業と完了作業のクエリとグラフ
プロジェクトが参照するプロセスに基づいて、タスクやバグに次のフィールドを割り当てることができます。
| Process | [使用できるフィールド] |
|---|---|
| アジャイル | 元の見積もり、残存作業、完了作業 |
| スクラム | 残存作業 |
| CMMI | 元の見積もり、残存作業、完了作業 |
開発者ごとの残存作業時間の合計
スクラムのプラクティスに従ってタスクやバグの残存作業時間を見積もる場合、次のクエリとグラフで各開発者の残存作業時間量のロールアップを得ることができます。 In 演算子を使い、タスクとバグの両方を含めると、タスクとして追跡されているバグが含まれます。
クエリに列オプションとして残存作業時間を追加し、保存します。 残存作業時間の合計を表示するには、次のようにピボット グラフを追加します。
![[グラフの構成] ダイアログ、ピボット、開発者ごとの残存作業時間の合計](media/numeric/config-pivot-remaining-work-per-developer-area.png?view=azure-devops)
システム定義のスプリント バーンダウン グラフの詳細については、スプリント バーンダウンに関する記事を参照してください。
作業の見積もりと追跡に使用されるフィールド
次の表では、作業の追跡に使用できるアクティビティベースと数値のフィールドについて説明します。 開始日、完了日、目標とする日などの日付関連フィールドについては、「日付または現在のイテレーションによるクエリの実行」を参照してください。
フィールド名
説明
作業項目の種類
アクティビティ 1、2
タスクを完了するために必要なアクティビティの種類。このフィールドの使用方法の詳細については、容量計画に関する記事を参照してください。 使用できる値は、以下のとおりです。
- デプロイ
- デザイン
- 開発
- ドキュメント
- 必要条件
- テスト
アクティビティ フィールドは、ProcessConfiguration ファイルの Activity に割り当てられます。3
参照名=Microsoft.VSTS.Common.Activity、データ型=String
タスク、バグ4 (アジャイルとスクラム)
ビジネス価値
同じ種類の他の項目と比較してプロダクト バックログ項目またはフィーチャーの相対的なビジネス価値を把握する主観的な測定単位。 大きい数値が割り当てられている項目は、小さい数値が割り当てられている項目よりもビジネス価値が高いと見なされる必要があります。
参照名=Microsoft.VSTS.Common.BusinessValue、データ型=Integer
エピック、機能
タスクの実行に費やされた作業量。 時間数または日数で作業を指定できます。 このフィールドに関連付けられた固有の時間単位はありません。
参照名=Microsoft.VSTS.Scheduling.CompletedWork、データ型=Double
タスク、バグ4
作業分野 1、2
タスクに割り当てられているアクティビティまたは作業分野の種類。 このフィールドの使用方法の詳細については、容量計画に関する記事を参照してください。 使用できる値は、以下のとおりです。
- 分析
- 開発
- テスト
- ユーザー教育
- ユーザーの作業
作業分野フィールドは、ProcessConfiguration ファイルの Activity に割り当てられます。3
参照名=Microsoft.VSTS.Common.Discipline、データ型=String
タスク、バグ 4 (CMMI)
作業
バグまたはプロダクト バックログ項目のサイズを把握する主観的な測定単位。 項目に割り当てる作業量が大きいほど、実装に必要な作業量が多いということです。
また、このフィールド 3 はチームのベロシティと予測の計算にも使用されます。 これは ProcessConfiguration ファイルの Effort に割り当てられます。
参照名=Microsoft.VSTS.Scheduling.Effort、データ型=Double
プロダクト バックログ項目、バグ 4 (スクラム)
機能、エピック
ストーリー ポイント
ユーザー ストーリーのサイズを把握する主観的な測定単位。 ユーザー ストーリーに割り当てるポイントが大きいほど、実装に必要な作業量が多いということです。
また、このフィールド 3 はチームのベロシティと予測の計算にも使用されます。 これは ProcessConfiguration ファイルの Effort に割り当てられます。
参照名=Microsoft.VSTS. Scheduling.StoryPoints、データ型=Double
ユーザー ストーリー、バグ 4 (アジャイル)
サイズ
要件のサイズを把握する主観的な測定単位。 このサイズが大きいほど、実装するために、より多くの作業が必要です。
また、このフィールド3はチームのベロシティと予測の計算にも使用されます。 これは ProcessConfiguration ファイルの Effort に割り当てられます。
参照名=Microsoft.VSTS. Scheduling.Size、データ型=Double
要件、バグ 4 (CMMI)
最初の見積もり
このタスクを完了するために必要な作業量。 時間数または日数で作業を指定できます。 このフィールドに関連付けられた固有の時間単位はありません。
参照名=Microsoft.VSTS.Scheduling.OriginalEstimate、データ型=Double
タスク、バグ 4 (アジャイルと CMMI)
このタスクを完了するための残りの作業量。 時間数または日数で作業を指定できます。 このフィールドに関連付けられた固有の時間単位はありません。
このフィールド 3 は、バーンダウンの計算にも使用されます。 これは ProcessConfiguration ファイルの type="RemainingWork" に割り当てられます。
注意
Azure Boards の場合、タスクボードには、残存作業時間との関係で時間を表す "h" が常に表示されます。 TFS の場合、ProcessConfiguration ファイルの残存作業時間の型フィールドを変更することで、日の "d"、または他の任意のラベルを指定できます。
参照名=Microsoft.VSTS.Scheduling.RemainingWork、データ型=Double
タスク、バグ4
レビューが必要
タスクにレビューが必要であることを示します。 [はい] または [いいえ] (既定値) を指定できます。
参照名=Microsoft.VSTS.CMMI.RequiresReview、データ型=String
タスク (CMMI)
テストが必要
タスクにテストが必要であることを示します。 [はい] または [いいえ] (既定値) を指定できます。
参照名=Microsoft.VSTS.CMMI.RequiresTest、データ型=String
タスク (CMMI)
タスクの種類1
実装するタスクの種類を指定します。 使用できる値は、以下のとおりです。
- 修正措置
- 軽減活動
- 対応予定
参照名=Microsoft.VSTS.CMMI.TaskType、データ型=String
タスク、バグ4 (CMMI プロセス)
注意
- メニューの選択を変更するには、クラウド サービスまたは継承済みプロセスの場合は「フィールドの追加と管理」を、オンプレミス XML プロセスの場合はフィールドの追加と変更、ピック リストのカスタマイズに関する記事を参照してください。
- アクティビティ (アジャイルまたはスクラム) または作業分野 (CMMI) の容量ページに表示される値は、プロジェクト コレクションのインスタンス内のすべてのプロジェクトでそのフィールドに対して定義されたすべての値の和集合を反映します。 そのため、スプリント バックログ ページの容量に対して表示される値を制限するには、
type="Activity"に割り当てられたフィールドの値をすべてのプロジェクトで一致させる必要があります。 - ProcessConfiguration フィールドの割り当て (オンプレミスのみ) を変更するには、「プロセス構成 XML 要素のリファレンス」を参照してください。
- 各チームは、アジャイル ツールを構成して、バグを要件またはタスクと同様に扱うかどうかを決定することができます。 バグは要件またはタスクのいずれでも出現するため、要件レベルおよびタスク レベルの工数を見積もるために使うフィールドは、作業項目フォームに含まれます。
関連記事
カスタム フィールドの追加の詳細については、「作業追跡エクスペリエンスをカスタマイズする」を参照してください。
作業の計画と追跡に使う主なツールを次に示します。
作業項目やクエリの使用の詳細については、次を参照してください。
作業項目の種類間での数値のロールアップ
ロールアップでは、ある親のすべての子作業項目について、選択されたフィールドの値が合計されます。 Azure Boards では、タスクボード上でタスクの残存作業時間のロールアップがネイティブに用意されます。 その他のロールアップの要件については、次の記事を参照してください。
要件またはタスクのカテゴリに表示される項目は何ですか?
各プロセスについて、各カテゴリへの作業項目の種類の既定の割り当てを以下に示します。
| Process | 要件カテゴリ | タスクのカテゴリ |
|---|---|---|
| アジャイル | ユーザー ストーリー | タスク |
| スクラム | プロダクト バックログ項目 | タスク |
| CMMI | 要件 | タスク |
ただし、バグ作業項目の種類を、要件またはタスク カテゴリのいずれに表示するかは、各チームが決定できます。 「バックログとボードにバグを表示する」を参照してください。
カスタム作業項目の種類をバックログに追加できます。 詳細については、「作業項目の種類を追加して変更する、カスタム WIT をバックログまたはボードに追加する」を参照してください。
REST API
プログラムでクエリを操作するには、次の REST API リソースのいずれかを参照してください。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示