Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
Analytics サービスは、すべての Azure Boards の作業追跡定義と更新アクティビティを収集します。 ブラウザーで Analytics クエリを直接実行し、プロパティの組み合わせを使用して、クエリのフィルター処理、データの集計、レポートの作成を行うことができます。 詳細については、「 OData Analytics を使用した基本的なクエリの定義を参照してください。
この記事では、作業追跡分析レポートの生成に使用できるほとんどのプロパティについて説明します。 分析では、HTML/リッチ テキスト フィールドと履歴フィールドを除くすべての作業追跡フィールドがプロパティとして格納されます。 カスタム フィールドは、カスタム プロパティとして Analytics に自動的に追加されます。
注
この記事では、Analytics データ モデルでサポートされるエンティティ、プロパティ、および列挙型について説明します。 データ モデルに対してクエリを実行するには、「 Analytics の OData クエリを作成する」を参照してください。
エンティティ セットの概要
Analytics に対して作業追跡データのクエリを実行する場合は、 WorkItems エンティティ セットに対してクエリを実行して、状態レポートとロールアップ レポートを生成します。 WorkItemSnapshot エンティティ セットを使用して、傾向の生成、バーンダウン、レポートの作成を行います。
データをフィルター処理したり、レポート対象のプロパティを選択したりするには、 エリア、 イテレーション、 プロジェクト、 チーム などの他のエンティティの種類を使用します。 レポートの例については、 サンプル レポートとクイック リファレンス インデックスを参照してください。
注
テストの実行、テスト結果、またはその他のテスト データに関する状態レポートと傾向レポートを生成するには、 WorkItems エンティティ型と WorkItemSnapshot エンティティ型に対してクエリを実行し、 TestRuns、 TestPoints、 TestResultsDaily、 TestSuite、または TestPointHistorySnapshot エンティティ型に基づいてフィルター処理します。 詳細については、「 Test metadata reference for Azure DevOps」を参照してください。
| エンティティ セット | エンティティ型 | 説明 |
|---|---|---|
| 領域 | 領域 | 作業項目 エリア パス。エリア階層別にグループ化およびフィルター処理するためのプロパティが含まれます。 |
| 日付 | CalendarDate | リレーションシップを使用して他のエンティティをフィルター処理およびグループ化するために使用される日付。 |
| イテレーション | 反復 | 作業項目 のイテレーション パス。イテレーション階層別にグループ化およびフィルター処理するためのプロパティが含まれます。 |
| BoardLocations | BoardLocation | ボード列、スイムレーン、分割によって識別されるボード セルの位置 (履歴ボードの設定を含む)。 各ボード フィールドの説明については、「 ワークフローフィールドとボード フィールドを参照してください。 |
| 処理 | 処理 | 作業項目と作業項目の種類を展開またはフィルター処理するために使用されるバックログ情報。 プロセスを使用してレポートをフィルター処理する例については、「要件追跡サンプル レポート」を参照してください。 Analytics v2.0 バージョン以降でサポートされています。 |
| プロジェクト | プロジェクト | 組織またはプロジェクト コレクションに対して定義されているすべてのプロジェクト。 |
| タグ | タグ | 各プロジェクトのすべての作業項目タグ。 タグを使用してレポートをフィルター処理する例については、「リリース バーンダウン サンプル レポート」を参照してください。 |
| チーム | チーム | プロジェクトに対して定義されているすべてのチーム。 Teams を使用してレポートをフィルター処理する例については、「Power BI レポートにチーム スライサーを追加する」を参照してください。 |
| ユーザー | 利用者 | さまざまな作業項目のプロパティを展開またはフィルター処理するために使用されるユーザー情報 ( 割り当て対象 や 作成者など)。 |
| 作業項目ボードスナップショット | 作業項目ボードスナップショット | ボードの場所を含む、各カレンダー日付の各作業項目の状態を記述する複合エンティティ型。 傾向レポートを生成するために使用されます。 サンプル レポートについては、「 累積フローダイアグラム (CFD) サンプル レポート」を参照してください。 |
| WorkItemLinks | 作業項目リンク | 作業項目間のリンク ( 子、 親、 関連など)。 履歴のない最新のリビジョンのリンクのみが含まれており、ハイパーリンクは含まれません。 |
| WorkItemRevisions | WorkItemRevision | 現在のリビジョンを含むすべての履歴作業項目のリビジョン。 削除された作業項目は含まれません。 |
| WorkItemSnapshot | WorkItemSnapshot | 各カレンダー日付の各作業項目の状態を記述する複合エンティティ型。 傾向レポートをサポートするために使用されます。 サンプル レポートについては、「 バグ傾向のサンプル レポート」を参照してください。 |
| Workitem | Workitem | 作業項目の現在の状態。 状態レポートをサポートするために使用されます。 サンプル レポートについては、「 子作業項目の値を親サンプル レポートにロールアップする」を参照してください。 |
| 作業項目タイプフィールド | 作業項目タイプフィールド | 各作業項目の種類とプロセスの作業項目のプロパティ。 レポートの作成をサポートするために使用されます。 |
スナップショット
作業追跡スナップショット エンティティ セットは 、WorkItemSnapshot と WorkItemBoardSnapshot です。 スナップショットは毎日同時に Analytics に書き込み、その日の作業項目に対して定義された値のレコードを提供します。 スナップショットを使用して傾向レポートを生成できます。
既定では、すべてのスナップショット テーブルは日次スナップショット ファクト テーブルとしてモデル化されます。 時間範囲のクエリは各日の値を取得し、長い時間範囲では多数のレコードが生成されます。 このような高精度が必要ない場合は、毎週または毎月のスナップショットを使用できます。 詳細については、「 長い期間にわたる傾向クエリに対して週単位または月単位のスナップショットを使用する」を参照してください。
作業項目の改訂
作業項目を更新するたびに、新しいリビジョンが作成され、 System.RevisedDate フィールドに記録されます。これは履歴フィルターの指定に役立ちます。 変更日は、 RevisedDate (DateTime) プロパティと RevisedDateSK (Int32) プロパティで表すことができます。
パフォーマンスを最大限に高めるには、後者の日付サロゲート キー プロパティを使用します。 このキーは、リビジョンが作成された日付を示すか、アクティブまたは不完全なリビジョンの OData datetime null 値 "9999-01-01T00:00:00Z" を示します。
{startDate}以降のすべての日付が必要な場合は、クエリに次のフィルターを追加します:RevisedDateSK eq null or RevisedDateSK gt {startDateSK}。
WorkItemRevisions エンティティ セットを使用して、特定の作業項目のすべてのリビジョンを読み込みます。 このクエリは、削除された作業項目を含めずに、フィルター処理する作業項目に対して、現在のリビジョンを含むすべての履歴作業項目のリビジョンを返します。
エンティティ型間の共有プロパティ
Analytics ビューで選択できるプロパティは、通常の作業追跡フィールドと、選択した分析プロパティ ( [サイクル時間の日数 ] や [ リード タイムの日数] など) に対応します。 これらのプロパティは、特に指定しない限り、次のエンティティ型に対して定義されます。
- Workitem
- WorkItemRevision
- WorkItemSnapshot
- 作業項目ボードスナップショット
注
Analytics サービスは、HTML またはリッチ テキスト データ型 (
DescriptionフィールドやHistoryフィールドなど) が割り当てられた長いテキスト フィールドのデータを格納せず、リンクや添付ファイルの数は格納しません。 既定のプロセス テンプレートで定義されているフィールドの完全な一覧については、「 作業項目フィールドのインデックス」を参照してください。 データ型の説明については、「 クエリ フィールド、演算子、マクロ」を参照してください。次の表には、スクラムと機能成熟度モデル統合 (CMMI) プロセス固有のフィールドに関連付けられているすべてのプロパティは含まれていません。 これらのフィールドの一覧については、 CMMI 作業項目の追跡に使用されるフィールドを参照してください。
日付ベースまたはユーザー ベースのプロパティは、「カレンダーの日付、プロジェクト、およびユーザーのメタデータリファレンス」で説明されている CalendarDate エンティティ セットとユーザー エンティティ セットに関連付けられます。
次の表では、通常の作業追跡フィールドやその他の Analytics プロパティなど、Analytics ビューで選択できるほとんどのプロパティの一覧と説明を示します。
| 表示名 | プロパティ名 | データの種類 | 説明 | 参照名 |
|---|---|---|---|---|
| 承諾者 | Microsoft_VSTS_CodeReview_AcceptedBy |
UserSK | コード レビューに応答したユーザーの名前。 (CMMI プロセス) | Microsoft.VSTS.CodeReview.AcceptedBy |
| 承諾日 | AcceptedDate |
日付と時間 | ユーザーがコード レビューに応答した日時。 (CMMI プロセス) | Microsoft.VSTS.CodeReview.AcceptedDate |
| アクティブ化した人 |
ActivatedBy、ActivatedByUserSK |
UserSK | 作業項目をアクティブ化または再アクティブ化したチーム メンバーの名前。 | Microsoft.VSTS.Common.ActivatedBy |
| アクティブ化された日 | ActivatedDate |
日付と時間 | チーム メンバーがバグまたは作業項目をアクティブ化または再アクティブ化した日時。 | Microsoft.VSTS.CodeReview.ActivatedDate |
| アクティビティ | Activity |
糸 | タスクを実行するために割り当てられたアクティビティまたは規範の種類。 使用できる値は、Deployment、Design、Development、Documentation、Requirements、Testing です。 (アジャイル、スクラム、および基本プロセス) | Microsoft.VSTS.Common.Activity |
AnalyticsUpdatedDate |
DateTimeOffset (日付と時刻のオフセット) | エンティティが最後に更新されたデータと時刻。 | ||
| アプリケーションの種類 | 糸 | 利害関係者がフィードバックを提供するアプリケーションの種類。 既定値は 、Web アプリケーション、 リモート コンピューター、 クライアント アプリケーションです。 有効な型は、オンプレミスの XML プロセスを使用するプロジェクトのプロセス構成ファイルで指定されます。 | Microsoft_VSTS_Feedback_ApplicationType |
|
| エリア パス |
AreaPath、AreaSK |
糸 | 製品機能またはチーム 領域の作業項目のグループ化。 プロジェクト階層内の有効なノードである必要があります。 | System.AreaPath |
| 割当先 |
AssignedTo、AssignedToUserSK |
UserSK | 現在作業項目を所有しているチーム メンバーの名前。 | System.AssignedTo |
| 自動テスト ID | AutomatedTestId |
糸 | テスト ケースを自動化するテストの ID。 | Microsoft.VSTS.TCM.AutomatedTestId |
| 自動テスト名 | AutomatedTestName |
糸 | 作業項目をアクティブ化または再アクティブ化したチーム メンバーの名前。 | Microsoft.VSTS.TCM.AutomatedTestName |
| 自動テスト ストレージ | AutomatedTestStorage |
糸 | テスト ケースを自動化するテストを含むアセンブリ。 | Microsoft.VSTS.TCM.AutomatedTestStorage |
| 自動テストの種類 | AutomatedTestType |
糸 | テスト ケースを自動化するテストの種類。 | Microsoft.VSTS.TCM.AutomatedTestType |
| オートメーションの状態 | AutomatedStatus |
糸 | [ 自動]、[ 未自動化]、または [計画済み] の値が受け入れられたテスト ケースの状態。 | Microsoft.VSTS.TCM.AutomationStatus |
| バックログ優先順位 | BacklogPriority |
ダブル | バックログまたはボード上の項目のシーケンスをスタックランクまたは追跡するために使用されるシステムバックグラウンドプロセスによって割り当てられた番号。 (スクラム プロセス) | Microsoft.VSTS.Common.BacklogPriority |
| ブロック | Blocked |
糸 | 作業項目に対してそれ以上の作業を実行できないことを示します。 有効な値は [はい] または [いいえ] です。 (CMMI プロセス) | Microsoft.VSTS.CMMI.Blocked |
| ビジネス価値 | BusinessValue |
ダブル | 製品バックログ項目または機能の相対的なビジネス値を、同じ種類の他の項目と比較してキャプチャする主観的な測定単位。 割り当てられた数値が大きいアイテムは、割り当てられたアイテムよりもビジネス価値が低いと見なされます。 | Microsoft.VSTS.Common.BusinessValue |
| 変更者 |
ChangedBy、ChangedByUserSK |
UserSK | 最近作業項目を変更したユーザーの名前。 | System.ChangedBy |
| Changed Date (変更日) | ChangedDate |
日付と時間 | 作業項目が変更された日時。 | System.ChangedDate |
ChangedDateSK |
Int32 | 作業項目が変更された日付。組織に対して定義されているタイム ゾーンでYYYYMMDDとして表されます。 外部ツールで関連エンティティを結合するために使用されます。 |
||
ChangedOn |
［ナビゲーション］ | organizationにDate対して定義されているタイム ゾーンで、作業項目が変更された日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。 |
||
| クローズ者 |
ClosedBy、ClosedByUserSK |
UserSK | 作業項目を閉じたユーザーの名前。 | Microsoft.VSTS.Common.ClosedBy |
| 終了日 |
ClosedDate、 ClosedDateSK、 ClosedOn |
日付と時間 | 作業項目が閉じられた日時。 | Microsoft.VSTS.Common.ClosedDate |
| コメント数 | CommentCount |
Int32 | 作業項目の [ディスカッション ] セクションに追加されたコメントの数。 | System.CommentCount |
| コミット | Committed |
糸 | 要件がプロジェクトでコミットされているかどうかを示します。 有効な値は [はい] または [いいえ] です。 (CMMI プロセス) | Microsoft.VSTS.CMMI.Committed |
CompletedDateSK |
Int32 | 作業項目が 完了 状態カテゴリに関連付けられたワークフロー状態になったときに格納される、Analytics によってキャプチャされたナビゲーション プロパティの日付。 | ||
CompletedOn |
［ナビゲーション］ | 組織に定義されているタイム ゾーンで、作業項目が完了状態カテゴリに関連付けられたワークフロー状態に入った日付のDate エンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。 |
||
| 実績作業 | CompletedWork |
ダブル | タスクに費やされた作業量を測定します。 | Microsoft.VSTS.Scheduling.CompletedWork |
| 作成者 |
CreatedBy、CreatedByUserSK |
UserSK | 作業項目を作成したユーザーの名前。 | Microsoft.VSTS.Common.CreatedBy |
| [作成日] |
CreatedDate、CreatedDateSK |
日付と時間 | 作業項目が作成された日付。組織に対して定義されているタイム ゾーンで表されます。 フィルター処理と表示に一般的に使用されます。 | Microsoft.VSTS.Common.CreatedDate |
CreatedDateSK |
Int32 | 作業項目が作成された日付。組織に対して定義されているタイム ゾーンで YYYYMMDD として表されます。 外部ツールで関連エンティティを結合するために使用されます。 |
||
CreatedOn |
［ナビゲーション］ | organizationにDate対して定義されているタイム ゾーンで、作業項目が作成された日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。 |
||
| サイクル時間の日数 | CycleTimeDays |
ダブル | 最初に 進行中 または 解決済 みの状態カテゴリに入ってから 完了 状態カテゴリに入るサイクル時間。 詳細については、「 時間とサイクル時間のウィジェットを読み取るを参照してください。 | |
| 規範 | Discipline |
糸 | タスクに割り当てられたアクティビティまたは規範の種類。 使用できる値は、 分析、 開発、 テスト、 ユーザー教育、 ユーザー エクスペリエンスです。 (CMMI プロセス) | Microsoft.VSTS.Common.Activity |
| 期限 | DueDate |
日付と時間 | 問題または作業項目が解決される予測期限。 (アジャイル プロセス) | Microsoft.VSTS.Scheduling.DueDate |
| 作業 | Effort |
ダブル | 製品バックログ項目 (スクラム プロセス) または問題 (基本プロセス) が実装する必要がある作業の推定量。 | Microsoft.VSTS.Scheduling.Effort |
| 完了日 | FinishDate |
日付と時間 | スケジュールが作業項目を完了することを示す日付と時刻。 | Microsoft.VSTS.Scheduling.FinishDate |
| 発見されたビルド | FoundIn |
糸 | バグが見つかった製品ビルド番号 (リビジョンとも呼ばれます)。 | Microsoft.VSTS.Build.FoundIn |
| InProgress 日付 | InProgressDate |
日付と時間 | 分析は、作業項目が 進行中 の状態カテゴリに属する状態に移動された日時をキャプチャする保存された日付です。 | |
InProgressDateSK |
Int32 | 作業項目が[進行中]状態カテゴリに属する状態に移動された日付。組織で定義されているタイム ゾーンでYYYYMMDDとして表されます。 外部ツールで関連エンティティを結合するために使用されます。 |
||
| 統合ビルド | IntegrationBuild |
糸 | コードを組み込むか、バグを修正する製品ビルド番号。 | Microsoft.VSTS.Build.IntegrationBuild |
| 現在の状態 | IsCurrent |
ブール値 | 値を True に設定して、フィルター処理された一連の作業項目の最新のスナップショットを表示するデータのフィルター処理をサポートします。 エンティティ型 WorkItemRevision、 WorkItemBoardSnapshot、 BoardLocation に対して有効です。 |
|
| 1 日の最後のリビジョン | IsLastRevisionOfDay |
ブール値 | スナップショットが Trueに設定された日の最後のリビジョンを表していることを示します。 |
|
| 期間の最終改訂 | IsLastRevisionOfPeriod |
ブール値 | スナップショットが Trueに設定されている期間の最後のリビジョンを表していることを示します。 |
|
| 問題点 | Issue |
糸 | 共有ステップが予想される結果に関連付けられていることを示します。 使用できる値は [はい] と [いいえ] です。 | Microsoft.VSTS.Common.Issue |
| リード タイムの日数 | LeadTimeDays |
ダブル | 作業項目の作成または提案された状態カテゴリの入力から完了状態カテゴリへの入力から計算されたリード タイム。 詳細については、「 時間とサイクル時間のウィジェットを読み取るを参照してください。 | |
| 元の見積もり | OriginalEstimate |
ダブル | タスクを完了するために必要な作業量を測定します。 | Microsoft.VSTS.Scheduling.OriginalEstimate |
| 親作業項目 ID | ParentWorkItemId |
Int32 | 親としてリンクされている作業項目を識別する一意の ID。 ロールアップ レポートを生成する場合に便利です。 [親] フィールドは、エンティティ型 WorkItemRevision と WorkItem に対して有効です。 | System.Parent |
| 優先順位 | Priority |
Int32 | ビジネスに関連するバグ、問題、タスク、またはテスト ケースの主観的な評価。 値には 、1、 2、または 3 が含まれます。 | Microsoft.VSTS.Common.Priority |
| プロジェクト名 | ProjectName |
［ナビゲーション］ | 作業項目が属するプロジェクトの名前。 詳細については、「 プロジェクトのプロパティ」を参照してください。 | System.TeamProject |
ProjectSK |
GUID | 作業項目が属するプロジェクトに割り当てられた GUID。 | ||
| 評価 | Reason |
糸 | 星ベースのランク付けシステム (フィードバック応答) のレビュー担当者からアイテムが受信する星の数。 数値はシステムに格納され、 0 - 評価なし、 1 - Poor、 2 - Fair、 3 - Good、 4 - Very Good、または 5 - Excellent と書かれています。 WorkItemRevision エンティティ型と WorkItem エンティティ型に対して有効です。 | Microsoft.VSTS.Common.Rating |
| 理由 | Reason |
糸 | 作業項目が現在の状態である理由。 あるワークフロー状態から別のワークフロー状態への各遷移は、対応する理由に関連付けられます。 | System.Reason |
| 残存作業 | RemainingWork |
ダブル | タスクを完了するために残っている作業量を測定します。 | Microsoft.VSTS.Scheduling.RemainingWork |
| 解決者 |
ResolvedBy、ResolvedByUserSK |
UserSK | バグまたはユーザー ストーリーを解決したチーム メンバーの名前。 | Microsoft.VSTS.Common.ResolvedBy |
| 解決日 | ResolvedDate |
日付と時間 | バグまたはユーザー ストーリーが解決された日時。 | Microsoft.VSTS.Common.ResolvedDate |
ResolvedDateSK |
Int32 | 作業項目が解決された日付。組織に対して定義されているタイム ゾーンで YYYYMMDD として表されます。 外部ツールで関連エンティティを結合するために使用されます。 |
||
ResolvedOn |
［ナビゲーション］ | organizationにDate対して定義されたタイム ゾーンで、作業項目が解決された日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。 |
||
| 解決理由 | ResolvedReason |
糸 | バグが解決された理由 ( 修正済みなど)。 | Microsoft.VSTS.Common.ResolvedReason |
| リビジョン | Revision |
Int32 | 作業項目の履歴リビジョンに割り当てられた番号。 | System.Rev |
| 更新日 | RevisedDate |
日付と時間 | 作業項目が変更または更新された日時。 | |
RevisedDateSK |
Int32 | 作業項目が改訂された日付。組織に対して定義されているタイム ゾーンで YYYYMMDD として表されます。 外部ツールで関連エンティティを結合するために使用されます。 |
||
RevisedOn |
［ナビゲーション］ | organizationにDate対して定義されたタイム ゾーンで、作業項目が変更された日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。 |
||
| リスク | Risk |
ダブル | 作業項目の正常な完了に関する相対的な不確実性の主観的評価。 有効な値には 、1 - High、 2 - Medium、 および 3 - Low が含まれます。 | Microsoft.VSTS.Common.Risk |
| 重大度 | Severity |
ダブル | プロジェクトに対するバグ、問題、またはリスクの影響の主観的評価。 有効な値には 、1 - Critical、 2 - High、 3 - Medium、 および 4 - Low が含まれます。 | Microsoft.VSTS.Common.Severity |
| [サイズ] | Size |
ダブル | 要件で実装する必要がある作業量を見積もる。 (CMMI プロセス) | Microsoft.VSTS.Scheduling.Size |
| スタック順位 | StackRank |
ダブル | バックログまたはボード上の項目のシーケンスをスタックランクまたは追跡するために使用されるシステムバックグラウンドプロセスによって割り当てられた番号。 (アジャイル、スクラム、および基本プロセス) | Microsoft.VSTS.Common.StackRank |
| [開始日] | StartDate |
日付と時間 | 作業を開始するために作業項目に割り当てられた日付と時刻。 | Microsoft.VSTS.Scheduling.StartDate |
| 状態 | State |
糸 | 作業項目の現在の状態。 state の有効な値は、各種類の作業項目と、それに対して行われたカスタマイズに固有です。 | System.State |
| 状態カテゴリ | StateCategory |
糸 | Azure Boards と選択ダッシュボード ウィジェットが各ワークフローの状態を処理する方法。 状態カテゴリには、 提案済み、 進行中、 解決済み、 削除済み、 完了があります。 詳細については、「 ワークフローの状態と状態カテゴリを使用する方法を参照してください。 エンティティ型に対 WorkItemRevision してのみ有効です。 |
|
| 状態の変更日 | StateChangeDate |
日付と時間 | [状態] フィールドの値が変更された日付と時刻。 | Microsoft.VSTS.Common.StateChangeDate |
StateChangeSK |
Int32 | 作業項目の状態が変更された日付。組織に対して定義されているタイム ゾーンで YYYYMMDD として表されます。 外部ツールで関連エンティティを結合するために使用されます。 |
||
StateChangeOn |
［ナビゲーション］ | 組織に対して定義されているタイム ゾーンで、作業項目の状態が変更された日付の Date エンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。 |
||
| ストーリー ポイント | StoryPoints |
ダブル | ユーザー ストーリーが実装するために必要な作業量の見積もり 。一般的に合計として集計されます。 (アジャイル プロセス) | Microsoft.VSTS.Scheduling.StoryPoints |
| タグ | TagNames |
糸 | フィルター処理またはクエリを行うために 1 つ以上の作業項目に割り当てられたタグのセミコロン区切りのリスト。 | System.Tags |
| 目標とする日 | TargetDate |
日付と時間 | 問題またはその他の作業項目が解決または完了する予測期限。 | Microsoft.VSTS.Scheduling.TargetDate |
| テスト スイートの種類 | 糸 | テスト スイートの種類。 有効な値には、 クエリ ベース、 要件ベース、 静的が含まれます。 | Microsoft_VSTS_TCM_TestSuiteType |
|
| テスト スイートの種類 ID | Int64 | テスト スイート カテゴリに対応するシステム割り当て番号。 テスト スイートにのみ適用されます。 割り当てられた値は 、1 (静的)、 2 (クエリ ベース)、 3 (要件ベース) です。 | Microsoft_VSTS_TCM_TestSuiteTypeId |
|
| 時間の重要度 | TimeCriticality |
ダブル | 時間の経過に伴うビジネス価値の低下をキャプチャする主観的な測定単位。 値が大きいほど、エピックまたはフィーチャーは、本質的に値が小さい項目よりも時間が重要であることを示します。 | Microsoft.VSTS.Common.TimeCriticality |
| タイトル | Title |
糸 | チーム メンバーがリスト内の他の作業項目と区別するのに役立つ作業項目を要約した簡単な説明。 | System.Title |
| 値の領域 | ValueArea |
糸 | エピック、機能、またはバックログ項目によって対処される顧客価値の領域。 値には、 アーキテクチャ または ビジネスが含まれます。 | Microsoft.VSTS.Common.ValueArea |
| ウォーターマーク | Watermark |
糸 | 作業項目に加えられた変更と共にインクリメントされるシステム管理フィールド。 WorkItemRevision エンティティ型と WorkItem エンティティ型に対して有効です。 | System.Watermark |
| 作業項目 ID | WorkItemId |
Int32 | 作業項目に割り当てられた一意の識別子。 作業項目 ID は、組織内またはプロジェクト コレクション内のすべてのプロジェクトで一意です。 | System.Id |
WorkItemRevisionSK |
Int32 | 外部ツールが関連エンティティを結合するために使用する作業項目リビジョンの分析一意キー。 | ||
| 作業項目の種類 | WorkItemType |
糸 | 作業項目の種類の名前。 使用可能な作業項目の種類は、プロジェクトが使用するプロセスに基づいています。 詳細については、「 プロセスとプロセス テンプレートについて」を参照してください。 | System.WorkItemType |
ナビゲーション プロパティ
OData ナビゲーション プロパティは、別のエンティティを指すエンティティの参照属性です。 次の表に、ナビゲーション プロパティ、参照制約、および有効なエンティティ型の概要を示します。
| 表示名 | 名前 | 参照制約 | 参照プロパティ | 有効なエンティティ型 |
|---|---|---|---|---|
ChangedOn |
ChangedDateSK |
DateSK |
WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
ClosedOn |
ClosedDateSK |
DateSK |
WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
CreatedOn |
CreatedDateSK |
DateSK |
WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
ResolvedOn |
ResolvedDateSK |
DateSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
StateChangeOn |
StateChangeDateSK |
DateSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
InProgressOn |
InProgressDateSK |
DateSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
CompletedOn |
CompletedDateSK |
DateSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
ChangedOn |
ChangedDateSK |
DateSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
RevisedOn |
RevisedDateSK |
DateSK |
WorkItemRevision、 WorkItemSnapshot | |
Date |
DateSK |
DateSK |
WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
| 領域 | Area |
AreaSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
| BoardLocation | WorkItemRevision、 WorkItem、 WorkItemBoardSnapshot | |||
| イテレーション | Iteration |
IterationSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot | |
| 割当先 | AssignedTo |
AssignedToUserSK |
UserSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| 変更者 | ChangedBy |
ChangedByUserSK |
UserSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| 作成者 | CreatedBy |
CreatedByUserSK |
UserSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| アクティブ化した人 | ActivatedBy |
ActivatedByUserSK |
UserSK |
WorkItemRevision、WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| クローズ者 | ClosedBy |
ClosedBySK |
UserSK |
WorkItemRevision、 WorkItem、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| により解決 | ResolvedBy |
ResolvedByUserSK |
UserSK |
WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot |
| チーム | Area、 BoardLocation、 Iteration、 WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot | |||
| タグ | WorkItem、 WorkItemRevision、 WorkItemBoardSnapshot | |||
| プロジェクト | Project |
ProjectSK |
ProjectSK |
Tag、 WorkItemBoardSnapshot、 WorkItemLink、 WorkItemRevision、 WorkItemSnapshot、 WorkItemTypeField |
| 処理 | WorkItemRevision、 WorkItem、 WorkItemSnapshot | |||
| リビジョン | Workitem | |||
| リンク | Workitem | |||
| 子供 | Workitem | |||
| 親 | Workitem | |||
| 子孫 | Workitem | |||
| Workitem* | WorkItemId |
WorkItemRevision |
* WorkItem エンティティは、選択した組み込みの Analytics レポートとウィジェットの予測傾向をサポートする PredictTags 関数と Predict 関数もサポートしています。
BoardLocation と WorkItemBoardSnapshot
次の表は、示されていない限り、 BoardLocation エンティティ型と WorkItemBoardSnapshot エンティティ型に定義されているプロパティの一覧と説明です。 これらのフィールドを使用すると、チームのボード列、スイムレーン、またはバックログ レベル内の作業項目の状態に基づいて作業項目データをフィルター処理できます。 WorkItemBoardSnapshot エンティティ セットを照会する例については、「累積フローダイアグラム (CFD) サンプル レポート」を参照してください。
| 表示名 | プロパティ名 | データの種類 | 説明 |
|---|---|---|---|
| ボード ID | BoardId |
GUID | ボードに割り当てられた一意の GUID。 各チームは、1 つ以上のボードに関連付けられています。 |
| ボード カテゴリ参照名 | BoardCategoryReferenceName |
糸 | ボードの設定に使用する作業項目の種類カテゴリに割り当てられた名前。 たとえば、製品バックログ ボードは [要件] カテゴリに関連付けられています。 詳細については、 バックログまたはボードのカスタマイズ (継承プロセス) に関する記事を参照してください。 |
| ボード名 | BoardName |
糸 | ストーリー、バックログアイテム、フィーチャー、エピックなど、ボードに割り当てられた名前。 |
| ボード レベル | BoardLevel |
Int32 | ボードの階層内の位置に基づいてボードに割り当てられる番号。 |
| バックログの種類 | BacklogType |
糸 | バックログの種類の名前 (イテレーション、要件、ポートフォリオなど)。 |
| 列名 | ColumnName |
糸 |
作業中、クローズ、コミット済み、完了、カスタム列ラベルなど、作業項目が現在割り当てられているボード列の名前。 参照名: System.BoardColumn |
| 列の順序 | ColumnOrder |
Int32 | ボード内のシーケンスに関してボード列に割り当てられた番号。 |
| 完了 | Done |
列挙された | 分割列の場所のインジケーター。* |
| 列項目の制限 | ColumnItemLimit |
Int32 | シーケンスに関してボード列に割り当てられた番号。 |
| ボードが表示される | IsBoardVisible |
ブール値 | チームがボードを表示するために選択したかどうかを示します。 |
| 列の分割 | IsColumnSplit |
ブール値 | 進行中の作業を示すためにボード上の列の分割に関する説明に従って、列が [実行] 列と [完了] 列に分割されているかどうかを示します。 |
| 現在の状態 | IsCurrent |
ブール値 |
Trueに設定されている場合に、フィルター処理された作業項目の最新のスナップショットを表示するデータのフィルター処理をサポートするプロパティ。 |
| 既定のレーン | IsDefaultLane |
ブール値 |
Trueに設定すると、作業項目が既定のスイムレーンに割り当てられていることを示します。 |
| 完了 | IsDone |
ブール値 | 列内の作業項目の現在の割り当ては、False場合は [実行]、True場合は [完了] です。 ボード 列に対して分割列 が有効になっている場合にのみ有効です。 参照名: System.BoardColumnDone |
| レーン ID | LaneId |
GUID | ボード スイムレーンに割り当てられた一意の GUID。 各チームは、ボードに 1 つ以上のスイムレーンを追加できます。 スイムレーンの詳細については、「 ボードでスイムレーンを使用してチームの作業を高速化するを参照してください。 |
| レーン名 | LaneName |
糸 | ボード スイムレーンに割り当てられた名前。 参照名: System.BoardLane |
| レーンの順序 | LaneOrder |
Int32 | シーケンスの観点からボード スイムレーンに割り当てられた番号。 |
*次の表に、 BoardColumnSplit 列挙型のメンバー名を示します。この名前を使用すると、[ 実行 ] または [完了] ボードの列の作業項目をフィルター処理できます。
| メンバー名 | 値 | 表示名 |
|---|---|---|
Doing |
0 | 実行中 |
Done |
1 | 完了 |
Unknown |
2 | 不明 (分割されていません) |
チームのボード列の詳細については、次の記事を参照してください。
領域
次のプロパティは、[エリア パス] フィールドに関連付けられている Areas エンティティ セットに対して有効です。
Area に関連付けられている代理キーには、 と がAreaSK含まれますProjectSK。 これらのプロパティを使用して、エリア パスの割り当てに基づいて作業追跡データをフィルター処理またはレポートできます。
| 表示名 | 名前 | データの種類 | 説明 |
|---|---|---|---|
AnalyticsUpdatedDate |
日付と時間 | 分析データが最後に更新された時刻を示す透かし。 | |
Number |
Int32 | 作成時にエリア パス ノードに割り当てられる整数値。 | |
| [奥行] | Depth |
Int32 | ルート レベルからの深さに基づくエリア パスのレベル。 |
| エリア ID | AreaId |
GUID | 作成時にエリア パスに割り当てられる一意の識別子。 |
| エリア レベル 1 ~ エリア レベル 14 |
AreaLevel1 から AreaLevel14 |
糸 | 最大 14 レベルの入れ子になったエリア パスのノード レベル。 区分レベル 1 は、常にルート ノードとプロジェクト名に対応します。 |
| 領域の名前 | AreaName |
糸 | 作成時にエリア パスに定義された名前。 |
| エリア パス | AreaPath |
糸 | ルート ノードから始まるエリア パスの完全パス。 |
重要
エリア パスの値を削除するか、繰り返しパスの値を再構成すると、次のグラフでは元に戻せないデータ損失が発生します。
- バーンダウンとバーンアップウィジェットチャート
- スプリント バーンダウン グラフ
- エリア パスが変更されたチームの速度グラフ
- 各作業項目の時点で定義された エリア パス と 反復パス の値を参照する履歴傾向グラフ
領域パスと反復パスは、作業項目で使用されなくなった場合にのみ削除できます。 これらのパスを削除すると、履歴データを取得できなくなります。
エリア エンティティの種類と Areas エンティティ セットのナビゲーション プロパティには、Project と Teams が含まれます。
エリア パスの詳細については、次の記事を参照してください。
イテレーション
次のプロパティは、イテレーション パス フィールドに関連付けられている Iterations エンティティ セットに対して有効です。
イテレーションに関連付けられている代理キーには、 と がIterationSK含まれますProjectSK。 これらのプロパティを使用して、イテレーション パスの割り当てに基づいて作業追跡データをフィルター処理またはレポートできます。
| 表示名 | 名前 | データの種類 | 説明 |
|---|---|---|---|
AnalyticsUpdatedDate |
日付と時間 | 分析データが最後に更新された時刻を示す透かし。 | |
Number |
Int32 | 作成時に反復パス ノードに割り当てられる整数値。 | |
| [奥行] | Depth |
Int32 | ルート レベルからの深さに基づく反復パスのレベル。 |
| 終了日 | EndDate |
日付と時間 | イテレーション パスに対して定義された終了日。 |
| IsEnded | IsEnded |
ブール値 |
Trueに設定されている場合、イテレーション パスの終了日が過去であることを示します。 |
| イテレーション ID | IterationId |
GUID | 作成時にイテレーション パスに割り当てられる一意の識別子。 |
| イテレーション レベル 1 から イテレーション レベル 14 |
IterationLevel1 から IterationLevel14 |
糸 | 最大 14 レベルの入れ子になった反復パスのノード レベル。 反復レベル 1 は、常にルート ノードとプロジェクト名に対応します。 |
| イテレーション名 | IterationName |
糸 | 作成時にイテレーション パスに定義される名前。 |
| イテレーション パス | IterationPath |
糸 | ルート ノードから始まる完全な反復パス。 このイテレーションは、プロジェクト階層で有効なノードである必要があります。 参照名: System.IterationPath |
| [開始日] | StartDate |
日付と時間 | イテレーション パスに対して定義された開始日。 |
重要
エリア パスの値を削除するか、繰り返しパスの値を再構成すると、次のグラフでは元に戻せないデータ損失が発生します。
- バーンダウンとバーンアップウィジェットチャート
- スプリント バーンダウン グラフ
- エリア パスが変更されたチームの速度グラフ
- 各作業項目の時点で定義された エリア パス と 反復パス の値を参照する履歴傾向グラフ
領域パスと反復パスは、作業項目で使用されなくなった場合にのみ削除できます。 これらのパスを削除すると、履歴データを取得できなくなります。
イテレーション エンティティ型とイテレーション エンティティ セットのナビゲーション プロパティには、Project と Teams が含まれます。
Iteration パスの詳細については、次の記事を参照してください。
プロセス
次のプロパティは、 Process エンティティ型と Process エンティティ セットに対して有効です。
Process に関連付けられている代理キーには、、ProcessSK、および ProjectSKが含まれますTeamSK。 これらのプロパティを使用して、プロジェクトまたはチームの作業項目の種類に関する作業追跡データをフィルター処理またはレポートします。
注
v-2.0、v3.0-preview、および v4.0-preview Analytics バージョンでは、Process エンティティの種類とプロセス エンティティ セットがサポートされています。
これらのプロパティを使用して、バックログ レベルに基づいて作業追跡データをフィルター処理できます。
| 表示名 | 名前 | データの種類 | 説明 |
|---|---|---|---|
AnalyticsUpdatedDate |
日付と時間 | 分析データが最後に更新された時刻を示す透かし。 | |
ProjectSK |
GUID | プロセスに関連付けられているプロジェクト キー。 | |
TeamSK |
GUID | プロセスに関連付けられているチーム キー。 | |
| バックログ カテゴリ参照名 | BacklogCategoryReferenceName |
糸 | 作業項目の種類に関連付けられているバックログに割り当てられたカテゴリ参照名。 例としては、 Microsoft.EpicCategory、 Microsoft.FeatureCategory、 Microsoft.RequirementCategory、 Microsoft.TaskCategoryなどがあります。 |
| バックログ名 | BacklogName |
ブール値 | 作業項目の種類に関連付けられているバックログに割り当てられた参照名 |
| バックログの種類 | BacklogType |
GUID | 作成時にバックログに割り当てられる一意の識別子。 |
| バックログ レベル | BacklogLevel |
糸 | 作業項目の種類に関連付けられているバックログ レベル。
null値は、作業項目の種類がバックログ レベルに関連付けられていない場合に返されます。 |
| 作業項目の種類 | WorkItemType |
糸 | 作業項目の種類に対して定義された名前。 |
| バックログがある | HasBacklog |
糸 | 作業項目の種類がバックログに属しているかどうかを示します。 |
| 非表示の型 | IsHiddenType |
ブール値 | 作業項目の種類が無効かどうかを示します。 |
| バグの種類 | IsBugType |
ブール値 | 作業項目の種類が バグ カテゴリに属しているかどうかを示します。 |
| 削除済み | IsDeleted |
ブール値 | 作業項目の種類が削除されているかどうかを示します。 |
プロセス バックログと作業項目の種類の詳細については、次の記事を参照してください。
タグ
次のプロパティは、 Tags エンティティ セットに対して有効です。
Tag に関連付けられているサロゲート キーには、 と がTagSK含まれますProjectSK。 ナビゲーション プロパティには、 Project とその参照制約 ProjectSKが含まれます。 タグの使用の詳細については、「 作業項目タグを追加してリストとボードを分類およびフィルター処理するを参照してください。
これらのプロパティを使用して、作業追跡データをフィルター処理またはレポートできます。
| 表示名 | 名前 | データの種類 | 説明 |
|---|---|---|---|
| タグ ID | TagId |
GUID | 作成時にタグに割り当てられた一意の ID。 |
| タグ名 | TagName |
糸 | タグ名。 |
チーム
次のプロパティは、 Team エンティティの種類と Teams エンティティ セットに対して有効です。
Team に関連付けられている代理キーには、 と がTeamSK含まれますProjectSK。 これらのプロパティを使用して、チームの割り当てに基づいて作業追跡データをフィルター処理またはレポートできます。 チームの使用と追加の詳細については、「 チームとアジャイル ツールについて」および「チーム を 作成または追加する」を参照してください。
| 表示名 | 名前 | データの種類 | 説明 |
|---|---|---|---|
AnalyticsUpdatedDate |
日付と時間 | 分析データが最後に更新された時刻を示す透かし。 | |
| チーム ID | TeamId |
GUID | 作成時にチームに割り当てられた一意の ID。 |
| チーム名 | TeamName |
糸 | チーム名。 |
Teams エンティティ セットのナビゲーション プロパティには、プロジェクト、領域、イテレーションが含まれます。
作業項目リンク
次のプロパティは、 WorkItemLinks エンティティ セットに対して有効です。 プロパティ参照サロゲート キーは です WorkItemLinkSK。
WorkItemLinks にクエリを実行して、親/子、関連、先行/後続、またはその他のリンクの種類に関するレポートを作成します。
| 表示名 | 名前 | データの種類 | 説明 |
|---|---|---|---|
AnalyticsUpdatedDate |
日付と時間 | 分析データが最後に更新された時刻を示す透かし。 | |
WorkItemLinkSK |
Int32 | WorkItemLink エンティティに割り当てられたサロゲート キー。 | |
| [作成日] | CreatedDate |
GUID | リンクが作成された日付。 |
| 解説 | Comment |
糸 | リンクの作成時に追加されたコメント。 |
| 削除日 | DeletedDate |
糸 | リンクが削除された日付。 |
| リンクの種類 ID | LinkTypeId |
Int32 | ターゲットのリンクされた作業項目に割り当てられた ID。 |
| リンクの種類名 | LinkTypeName |
糸 | リンクの種類に割り当てられたフレンドリ名。 |
| リンクの種類の参照名 | LinkTypeReferenceName |
糸 | リンクの種類に割り当てられた参照名。 |
| リンクの種類が非巡回である | LinkTypeIsAcyclic |
ブール値 | リンクの種類で、 Trueに設定すると循環リレーションシップが許可されることを示します。 たとえば、ツリー型のリンクは循環リレーションシップを制限します。 |
| リンクの種類が方向 | LinkTypeIsDirectional |
ブール値 | リンクの種類が方向かどうかを示します。 方向リンクの種類は、前方コンポーネントと逆方向コンポーネントとのペアで定義されます。 |
| ソース作業項目 ID | SourceWorkItemId |
Int32 | リンク 元の作業項目に割り当てられた ID。 |
| ターゲット作業項目 ID | TargetWorkItemId |
Int32 | リンク 先の作業項目に割り当てられた ID。 |
WorkItemLink エンティティ型のナビゲーション プロパティには、Projects、SourceWorkItem、および TargetWorkItem が含まれます。
リンクとリンクの種類の詳細については、次の記事を参照してください。
作業項目タイプフィールド
次のプロパティは、 WorkItemTypeFields エンティティ セットに対して有効です。 プロパティ参照キーは、 FieldName、 ProjectSK、および WorkItemTypeです。
| 表示名 | 名前 | データの種類 | 説明 |
|---|---|---|---|
| フィールド名 | FieldName |
糸 | システムまたは作成時にフィールドに割り当てられたフレンドリ名。 |
| フィールド参照名 | FieldReferenceName |
糸 | システムまたはユーザー設定フィールドの作成時にフィールドに割り当てられる参照名。 |
| フィールドの型 | FieldType |
糸 | フィールドに割り当てられたデータ型。 |
| 作業項目の種類 | WorkItemType |
糸 | フィールドが定義されている作業項目の種類。 |
ナビゲーション プロパティには Project が含まれます。 プロジェクトに対して定義されているすべてのフィールドのインデックスについては、「 作業項目フィールドのフィールドの説明」を参照してください。 詳細については、次の記事を参照してください。
カスタム プロパティ
カスタム フィールドは、カスタム プロパティとして Analytics サービスに自動的に追加されます。
Custom_ または Custom. がプロパティ名の前に付加されます。 「メタデータのクエリ」の説明に従って、コレクション のメタデータを確認します。 次の例は、ユーザー設定フィールド Risk Opportunity のメタデータ構文を示しています。
<Property Name="Custom_RiskOpportunity" Type="Edm.Double">
<Annotation Term="Display.DisplayName" String="Risk Opportunity"/>
<Annotation Term="Ref.ReferenceName" String="Custom.RiskOpportunity"/>
<Annotation Term="Display.Description" String="Risk Reduction | Opportunity Enablement Value. Enter a value from 1 to 5. 5 represents high risk reduction or high opportunity enablement."/>
</Property>
カスタム作業項目の種類とバックログ カテゴリ
カスタム作業項目の種類のデータは、Analytics サービスに自動的に追加されます。 カスタム カテゴリは、カスタム作業項目の種類とバックログ レベルが定義され、 Custom_ または Custom. カテゴリ GUID の前に追加されたときに作成されます。 たとえば、 Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000 などのカスタム カテゴリは、ポートフォリオ バックログの ポートフォリオ カスタム作業項目の種類に割り当てることができます。