Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
Azure Boards と Azure DevOps の作業量、スケジュールの見積もり、ストーリー ポイント、時間追跡フィールドなどの数値フィールドでクエリを実行する方法について説明します。
一般的な数値項目は、要件の努力、またはタスクの見積もり、残り、完了した作業を追跡します。 クエリを使用して、関心のある作業項目を一覧表示し、作業項目の数または数値フィールドの合計を表示するグラフを作成します。
必須コンポーネント
| カテゴリ | 要件 |
|---|---|
| アクセス レベル | 共有クエリを表示し実行するには、のプロジェクトメンバーが必要です。 - 共有クエリを追加して保存するには:少なくとも Basic アクセス。 |
| アクセス許可 | クエリを追加するフォルダーで [共同作成] アクセス許可が [許可] に設定されていること。 既定では、共同作成者グループにはこのアクセス許可がありません。 |
メモ
パブリック プロジェクトの 利害関係者 アクセスが付与されたユーザーは、 基本 アクセスが付与されたユーザーと同様に、クエリ機能へのフル アクセス権を持っています。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。
| カテゴリ | 要件 |
|---|---|
| アクセス レベル | 共有クエリを表示し実行するには、のプロジェクトメンバーが必要です。 - 共有クエリを追加して保存するには: Basic 以上のアクセス レベルが必要です。 |
| アクセス許可 | クエリを追加するフォルダーで [共同作成] アクセス許可が [許可] に設定されていること。 既定では、共同作成者グループにはこのアクセス許可がありません。 |
演算子とマクロの使用
数値フィールドを参照する句は、次の演算子をサポートします。
-
=、<>、>、<、>=、<= -
=[Field]、<>[Field]、>[Field]、<[Field]、>=[Field]、<=[Field] -
In、Not In Was Ever
グラフベースのクエリの開発
グラフをフィードするクエリを作成するためのヒント:
- フラット リスト クエリにのみグラフを追加します。
- クエリ フィルター、または列オプションで表示されるフィールドを参照します。
- グラフを追加または変更する前に、クエリを保存します。
- 句をグループ化するには、それらを選択し、句のグループ化アイコンを使用します。グループ化を解除するには、グループ化された句を選択します。
詳細については、「 クエリ エディターを使用して、クエリ、 グラフ、 フィールドの追加または変更を一覧表示および管理する」を参照してください。
フィルターの使用
次の表はクエリに役立つフィルターをまとめたものです。
フィルターの対象
含めるクエリ句
ユーザー ストーリーまたはバグ
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-server)
状態とエリア別のバグ カウント用のクエリ
同じフラット リスト クエリを使用して、面パスを列として含め、状態とエリアでグループ化されたピボット グラフを追加します。
![[状態] と [エリア パス] でピボットするように構成された [グラフの構成] ダイアログを示すスクリーンショット。](media/numeric/config-pivot-state-area.png?view=azure-devops-server)
未定義フィールド値用のクエリ
"equals" 演算子 = を使用し、値を空白のままにして、未定義の (空白の) フィールド値を持つ作業項目を検索します。 たとえば、この句は、[ストーリー ポイント] フィールドが空白のユーザー ストーリーを検索します。
フィールドが空白でない項目を検索するには、"not" 演算子 <> 使用し、値を空白のままにします。
工数またはストーリー ポイント用のクエリ
アジャイル プロセスのユーザー ストーリーまたはバグにストーリー ポイントを割り当てます。 スクラム プロセスで製品バックログ項目とバグに対して作業量を使用します。 詳細については、「 Basic、 Agile、 Scrum、または CMMI」を参照してください。
ストーリーポイントの合計とそのステータスを問い合わせる
ユーザー ストーリーをフィルター処理し、ストーリー ポイントと状態を列に追加するクエリを作成します。
![[ストーリー ポイント] 列と [状態] 列を含む開いているストーリーのクエリ エディターのフラット リストを示すスクリーンショット。](media/query-effort-sum-story-points-iteration.png?view=azure-devops-server)
次に、ストーリー ポイントを合計する積み上げ横棒グラフを追加します。
![ストーリー ポイントを合計する積み上げ横棒グラフの [グラフの構成] ダイアログを示すスクリーンショット。](media/numeric/config-psum-story-points-stacked-bar.png?view=azure-devops-server)
累積フロー図の詳細については、「 累積フロー」を参照してください。
イテレーションのユーザー ストーリーのバーンアップ チャート用のクエリ
アクティブまたはクローズ状態のユーザー ストーリーをフィルター処理し、列にストーリー ポイントを含めるクエリを作成します。
次に、ストーリー ポイントを合計する積み上げ面傾向グラフを追加します。
![ストーリー ポイントを合計する傾向グラフの [グラフの構成] ダイアログを示すスクリーンショット。](media/numeric/config-trend-sum-story-points.png?view=azure-devops-server)
残りの作業と完了した作業用のクエリ
プロセスに応じて、プロジェクトにはタスクまたはバグに次のフィールドを含めることができます。
| プロセス | [使用できるフィールド] |
|---|---|
| アジャイル | 元の見積もり、残存作業、完了作業 |
| スクラム | 残存作業 |
| CMMI | 元の見積もり、残存作業、完了作業 |
開発者ごとの残存作業時間の合計
タスクとバグの残存作業時間を見積もる場合は、 In 演算子を使用し、タスクとバグの両方を含むクエリでロールアップを取得し、タスクとして追跡されたバグを含めます。
残存作業時間を列として追加し、保存してからピボット グラフを追加して、開発者ごとの残存作業時間の合計を表示します。
![[割り当て済み作業時間と残存作業時間の合計] でピボットするようにグラフを構成するダイアログを示すスクリーンショット。](media/numeric/config-pivot-remaining-work-per-developer-area.png?view=azure-devops-server)
システム定義のスプリント バーンダウン グラフについては、「 スプリント バーンダウン」を参照してください。
作業の見積もりと追跡に使用されるフィールド
次の表では、作業の追跡に使用できるアクティビティ ベースのフィールドと数値フィールドについて説明します。 開始日、終了日、ターゲット日付などの日付関連フィールドについては、「 日付または現在のイテレーションによるクエリ」を参照してください。
フィールド名
説明
作業項目の種類
アクティビティ 1、2
タスクを完了するために必要なアクティビティ。 容量計画については、 容量計画を参照してください。 使用できる値は、以下のとおりです。
- 配置
- 設計
- 開発
- ドキュメント
- 要件
- テスト
[アクティビティ] フィールドは、ProcessConfiguration ファイル内の Activity にマップされます。3
参照名=Microsoft.VSTS.Common.Activity、データ型=String
タスク、バグ4 (アジャイルとスクラム)
ビジネス価値
製品バックログ項目または機能の相対的なビジネス価値の主観的尺度。 数値が大きいほど、相対的な値が大きいことを示します。
Reference name=Microsoft.VSTS.Common.BusinessValue, データタイプ=Integer
エピック、機能
タスクの実行に費やされた作業量。 勤務時間または日数を記録できます。固有の時間単位は適用されません。
参照名=Microsoft.VSTS.Scheduling.CompletedWork、データ型=Double
タスク、バグ4
作業分野 1、2
タスクに割り当てられた規範。 容量計画を参照してください。 使用できる値は、以下のとおりです。
- 分析
- 開発
- テスト
- ユーザー教育
- ユーザーの作業
[規範] フィールドは、ProcessConfiguration ファイル内の Activity にマップされます。3
参照名=Microsoft.VSTS.Common.Discipline、データ型=String
タスク、バグ 4 (CMMI)
工数
バグまたは製品バックログ項目のサイズの主観的な尺度。 チームの速度と予測を計算するには、エフォートを使用します。ProcessConfiguration ファイル内の Effort にマップされます。
参照名=Microsoft.VSTS.Scheduling.Effort、データ型=Double
プロダクト バックログ項目、バグ 4 (スクラム)
機能、エピック
ストーリー ポイント
ユーザー ストーリーのサイズの主観的な尺度。 ストーリー ポイントは、チームの速度と予測に貢献し、ProcessConfiguration ファイル内の Effort にマップします。
Reference name=Microsoft.VSTS.Scheduling.StoryPoints, Data type=Double
ユーザー ストーリー、バグ 4 (アジャイル)
サイズ
要件サイズの主観的な尺度。 サイズは速度に影響し、ProcessConfiguration ファイル内の Effort にマップされます。
参照名=Microsoft.VSTS.Scheduling.Size、データ型=Double
要件、バグ 4 (CMMI)
最初の見積もり
タスクを完了するために見積もられた作業の初期量。 時間または日で表されます。固有の単位は適用されません。
参照名=Microsoft.VSTS.Scheduling.OriginalEstimate、データ型=Double
タスク、バグ 4 (アジャイルと CMMI)
このタスクを完了するための残りの作業量。 時間または日数で記録されます。固有の単位は適用されません。 残存作業は、バーンダウン チャートに反映され、ProcessConfiguration ファイル内の RemainingWork にマッピングされます。
メモ
Azure Boards の場合、タスクボードには残存作業時間の "h" (時間) が表示されます。 オンプレミスの XML プロセス構成の場合は、ProcessConfiguration ファイルを変更してラベル（たとえば、日を示す "d"）を変更できます。
リファレンス名=Microsoft.VSTS.Scheduling.RemainingWork, データ型=Double
タスク、バグ4
レビューが必要
タスクにレビューが必要であることを示します。 使用できる値: はい または いいえ (既定値)。
参照名=Microsoft.VSTS.CMMI.RequiresReview、データ型=文字列
タスク (CMMI)
テストが必要
タスクにテストが必要であることを示します。 使用できる値: はい または いいえ (既定値)。
参照名=Microsoft.VSTS.CMMI.RequiresTest、データ型=文字列
タスク (CMMI)
タスクの種類1
タスクの種類を指定します。 使用できる値は、以下のとおりです。
- 修正措置
- 軽減活動
- 対応予定
参照名=Microsoft.VSTS.CMMI.TaskType、データ型=String
タスク、バグ4 (CMMI プロセス)
メモ
- 選択リストの値を変更するには:クラウド サービスまたは継承されたプロセスについては、「 フィールドの追加と管理」を参照してください。オンプレミスの XML プロセスの場合は、 フィールドの追加または変更を使用し、選択リストをカスタマイズします。
- [容量] ページには、プロジェクト コレクション内のプロジェクト間でフィールドに定義されているすべての値の和集合が表示されます。 [容量] ページに表示される値を制限するには、
type="Activity"に割り当てられたフィールドを共有するすべてのチームで値を一致させます。 - ProcessConfiguration フィールドの割り当て (オンプレミスのみ) を変更するには、「プロセス構成 XML 要素のリファレンス」を参照してください。
- 各チームは、バグが要件やタスクのように動作するかどうかを構成します。 いずれかのバグが発生する可能性があるため、両方のレベルで作業量を見積もるために使用されるフィールドが作業項目フォームに含まれます。
次のステップ
関連コンテンツ
- バックログを作成する
- スプリントを計画する
- 容量を計画する
- 作業項目クエリを定義する
- クエリのフィールド、演算子、およびマクロ
- 作業およびその他のフィールドのロールアップのサポート
- Power BI を使ってロールアップ グラフを作成する
REST API
プログラムでクエリを操作するには、次の REST API リソースのいずれかを参照してください。