次の方法で共有

Azure Boards Analytics のメタデータ リファレンス

  • [アーティクル]

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

Analytics サービスは、Azure Boardsを通じて定義および更新されたすべての作業追跡アクティビティを収集します。 分析では、HTML/リッチ テキスト フィールドと履歴フィールドを除き、すべての作業追跡フィールドがプロパティとして格納されます。 カスタム フィールドのカスタム プロパティは、Analytics に自動的に追加されます。

この記事では、作業追跡用の分析レポートを生成するために使用できるプロパティの大部分について説明します。 プロパティの組み合わせを使用して、クエリのフィルター処理、データの集計、またはレポートの作成を行います。 これらのクエリは、ブラウザーで直接実行できます。 詳細については、「 OData Analytics を使用した基本的なクエリの定義を参照してください。 作業の追跡とAzure Boardsを初めて使用する場合は、次の記事を確認することをお勧めします。

Note

Analytics データ モデルでサポートされるエンティティ、プロパティ、列挙型の説明が提供されます。 これは初期のドラフトです。 詳細情報を取得したい領域に関するフィードバックをお寄せください。 データ モデルに対してクエリを実行するには、「 Analytics の OData クエリを作成する」を参照してください。

エンティティ セットの概要

Analytics に対して作業追跡データのクエリを実行する場合は、次のいずれかのエンティティ型またはエンティティ セットを使用します。

  • 状態レポートとロールアップ レポートを生成するためのクエリWorkItems
  • 傾向、バーンダウン、バーンアップ レポートを生成するクエリWorkItemSnapshot

データをフィルター処理したり、レポート対象のプロパティを選択したりするには、他のエンティティの種類 (、IterationProjectTeamまたは他のエンティティなどArea) を使用します。 サンプル レポートの概要については、「 サンプル レポートとクイック リファレンス インデックス」を参照してください。

Note

テスト固有の作業項目の種類に関する状態レポートと傾向レポートを生成するには、 と WorkItemSnapshot エンティティの種類に対してクエリをWorkItems実行し、作業項目の種類に基づいてフィルター処理します。 テストの実行、テスト結果、またはその他のテスト データについては、、 TestSuiteTestPointsTestResultsDailyまたは TestPointHistorySnapshot エンティティ型に対してクエリをTestRuns実行します。 詳細については、「 Test metadata reference for Azure DevOps」を参照してください。

EntitySet EntityType 説明
領域 領域 作業項目 エリア パス。エリア階層別にグループ化およびフィルター処理するためのプロパティが含まれます。
日付 CalendarDate リレーションシップを使用して他のエンティティをフィルター処理およびグループ化するために使用される日付。
イテレーション 反復 作業項目 イテレーション パス。イテレーション階層によるグループ化とフィルター処理のプロパティが含まれます。
BoardLocations BoardLocation ボード列、スイムレーン、および分割によって識別されるボード セルの場所には、履歴ボードの設定が含まれます。 各ボード フィールドの説明については、「 ワークフローフィールドとボード フィールドを参照してください。
プロセス Process 作業項目と作業項目の種類を展開またはフィルター処理するために使用されるバックログ情報。 プロセスを使用してレポートをフィルター処理する例については、「要件追跡サンプル レポート」を参照してください。 Analytics v2.0 バージョン以降でサポートされています。
プロジェクト プロジェクト organization (クラウド) またはプロジェクト コレクション (オンプレミス) に対して定義されているすべてのプロジェクト。
タグ Tag 各プロジェクトのすべての作業項目タグ。 タグを使用してレポートをフィルター処理する例については、「リリース バーンダウン サンプル レポート」を参照してください。
Teams チーム プロジェクトに対して定義されているすべてのチーム。 Teams を使用してレポートをフィルター処理する例については、「Power BI レポートにチーム スライサーを追加する」を参照してください。
ユーザー User さまざまな作業項目のプロパティ ( 割り当て先、 作成者など) を展開またはフィルター処理するために使用されるユーザー情報。
WorkItemBoardSnapshot WorkItemBoardSnapshot (複合)傾向レポートの生成に使用される、ボードの場所を含む各カレンダー日付の各作業項目の状態。 サンプル レポートについては、「 累積フローダイアグラム (CFD) サンプル レポート」を参照してください。
WorkItemLinks WorkItemLink 作業項目間のリンク ( 子、 親、 関連など)。 リンクの最新のリビジョンのみを含み、履歴は含まない。 ハイパーリンクは含まれません。
WorkItemRevisions WorkItemRevision 現在のリビジョンを含むすべての履歴作業項目のリビジョン。 削除された作業項目は含まれません。
WorkItemSnapshot WorkItemSnapshot (複合)傾向レポートをサポートするために使用される、各カレンダー日付の各作業項目の状態。 サンプル レポートについては、「 バグ傾向のサンプル レポート」を参照してください。
Workitem Workitem 作業項目の現在の状態。 状態レポートをサポートするために使用されます。 サンプル レポートについては、「 子作業項目の値を親サンプル レポートにロールアップする」を参照してください。
WorkItemTypeFields WorkItemTypeField 作業項目の種類とプロセスごとの作業項目のプロパティ。 レポートの作成をサポートするために使用されます。

スナップショットについて

エンティティ セットには、2 つの作業追跡スナップショットと があります WorkItemSnapshotWorkItemBoardSnapshot。

スナップショットは、毎日作業項目に定義されている値のレコードを提供します。 このレコードは、毎日同時に 1 日に 1 回 Analytics に書き込まれます。 傾向レポートを生成する場合は、スナップショットを使用します。 既定では、すべてのスナップショットテーブルは、毎日のスナップショットファクト テーブルとしてモデル化されます。 時間範囲のクエリを実行すると、各日の値が取得されます。 時間範囲が長い場合、多数のレコードが生成されます。 このような高精度が必要ない場合は、毎週または毎月のスナップショットを使用できます。

詳細については、「 OData クエリガイドライン」を参照してください。長期にわたる傾向クエリには週単位または月単位のスナップショットを使用してください。

作業項目のリビジョンについて

作業項目を更新するたびに、新しいリビジョンが作成され、このアクションがフィールドに System.RevisedDate 記録されるため、履歴フィルターを指定するのに役立ちます。 変更された日付は、(DateTime) プロパティと RevisedDateSK (Int32) プロパティでRevisedDate表されます。 最適なパフォーマンスを得るには、後者の日付サロゲート キーを使用します。 これは、リビジョンが作成された日付、またはアクティブまたは不完全なリビジョンに対して null を持つ日付を表します。

以降のすべての日付が必要な場合は {startDate} 、クエリに次のフィルターを追加します。

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

エンティティ セットを WorkItemRevisions 使用して、特定の作業項目のすべてのリビジョンを読み込みます。 クエリは、フィルター処理する作業項目に対して、現在のリビジョンを含むすべての履歴作業項目のリビジョンを返します。 削除された作業項目は含まれません。

複数のエンティティ型の共有プロパティ

分析ビューで選択できるプロパティは、通常の作業追跡フィールドに対応し、[サイクル時間の日] や [リード タイムの日] などの [分析] プロパティを選択します。 これらのプロパティは、特に指定がない限り、次の表に示すほとんどのプロパティが、次のエンティティ型に対して定義されています。

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • WorkItemBoardSnapshot

Note

Analytics サービスでは、HTML データ型またはリッチ テキスト データ型が割り当てられた長いテキスト フィールドのデータは格納されません。 これには、[ 説明] フィールドと [履歴 ] フィールドが含まれます。 Analytics では、リンクや添付ファイルの数も格納されません。 既定のプロセス テンプレートで定義されているフィールドの完全な一覧については、「 作業項目フィールドのインデックス」を参照してください。 各データ型の説明については、「 クエリ フィールド、演算子、マクロ」を参照してください。
次の表に、Scrum および CMMI プロセス固有のフィールドに関連付けられているすべてのプロパティが含まれているわけではありません。 これらのフィールドの一覧については、「 プロセス テンプレートで使用される既定のフィールドと作業項目フィールドのフィールドの説明」、「CMMI 作業項目を追跡するために使用されるフィールド」を参照してください。

多くのプロパティは、日付ベースまたはユーザーベースです。 これらのプロパティは、「カレンダーの日付、プロジェクト、およびユーザーのメタデータリファレンス」で説明されている CalendarDate エンティティ セットと User エンティティ セットに関連付けられています。

[表示名]
Property name		 データの種類 説明
Reference name
承諾者
Microsoft_VSTS_CodeReview_AcceptedBy		 UserSK コード レビューに応答したユーザーの名前。 (CMMI プロセス)
Microsoft.VSTS.CodeReview.AcceptedBy
承諾日
AcceptedDate		 DateTime ユーザーがコード レビューに応答した日時。 (CMMI プロセス)
Microsoft.VSTS.CodeReview.AcceptedDate
アクティブ化した人
ActivatedBy
ActivatedByUserSK		 UserSK 作業項目をアクティブ化または再アクティブ化したチーム メンバーの名前。
Microsoft.VSTS.Common.ActivatedBy
アクティブ化された日
ActivatedDate		 DateTime チーム メンバーがバグまたは作業項目をアクティブ化または再アクティブ化した日時。
Microsoft.VSTS.CodeReview.ActivatedDate
アクティビティ
Activity		 String タスクを実行するために必要なアクティビティの種類。
Microsoft.VSTS.Common.Activity

タスクに割り当てられているアクティビティまたは作業分野の種類。 使用できる値は、Deployment、Design、Development、Documentation、Requirements、Testing です。 (アジャイル、スクラム、および基本プロセス)
Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate DateTimeOffset エンティティが最後に更新されたデータと時刻。
アプリケーションの種類 String 関係者がフィードバックを提供するアプリケーションの種類。 既定値は 、Web アプリケーション、 リモート コンピューター、 およびクライアント アプリケーションです。 有効な型は、オンプレミスの XML プロセスを使用するプロジェクトのプロセス構成ファイルで指定されます。
Microsoft_VSTS_Feedback_ApplicationType
エリア パス
AreaPath
AreaSK		 String 作業項目を製品機能区分またはチーム区分に分類します。 この区分は、プロジェクト階層で有効なノードである必要があります。
System.AreaPath
割当先
AssignedTo
AssignedToUserSK		 UserSK 現在、作業項目を所有しているチーム メンバーの名前。
System.AssignedTo
自動テスト ID
AutomatedTestId		 String テスト ケースを自動化するテストの ID
Microsoft.VSTS.TCM.AutomatedTestId
自動テスト名
AutomatedTestName		 String 作業項目をアクティブ化または再アクティブ化したチーム メンバーの名前。
Microsoft.VSTS.TCM.AutomatedTestName
自動テスト ストレージ
AutomatedTestStorage		 String テスト ケースを自動化するテストを含むアセンブリ。
Microsoft.VSTS.TCM.AutomatedTestStorage
自動テストの種類
AutomatedTestType		 String テスト ケースを自動化するテストの種類。
Microsoft.VSTS.TCM.AutomatedTestType
オートメーションの状態
AutomatedStatus		 String 次の値が受け入れられたテスト ケースの状態: Automated、 Not Automated、または Planned。
Microsoft.VSTS.TCM.AutomationStatus
バックログ優先順位
BacklogPriority		 Double バックログまたはボード上の項目のシーケンスをスタックまたは追跡するために使用されるシステムバックグラウンドプロセスによって割り当てられた数値。 (スクラム プロセス)
Microsoft.VSTS.Common.BacklogPriority
ブロック
Blocked		 String 作業項目に対してそれ以上の作業を実行できないことを示します。 有効な値は [はい] または [いいえ] です。 (CMMI プロセス)
Microsoft.VSTS.CMMI.Blocked
ビジネス価値
BusinessValue		 Double 同じ種類の他の項目と比較してプロダクト バックログ項目またはフィーチャーの相対的なビジネス価値を把握する主観的な測定単位。 大きい数値が割り当てられている項目は、小さい数値が割り当てられている項目よりもビジネス価値が高いと見なされる必要があります。
Microsoft.VSTS.Common.BusinessValue
変更者
ChangedBy
ChangedByUserSK		 UserSK 作業項目を最後に変更したユーザーの名前。
System.ChangedBy
Changed Date (変更日)
ChangedDate		 DateTime 作業項目が変更された日時。
System.ChangedDate
ChangedDateSK Int32 作業項目が変更された日付。organizationに対して定義されているタイム ゾーンで表YYYYMMDDされます。 外部ツールで関連エンティティを結合するために使用されます。
ChangedOn ［ナビゲーション］ organizationにDate対して定義されているタイム ゾーンで、作業項目が変更された日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。
クローズ者
ClosedBy
ClosedByUserSK		 UserSK 作業項目を終了した人物の名前。
Microsoft.VSTS.Common.ClosedBy
終了日
ClosedDate
ClosedDateSK
ClosedOn		 DateTime 作業項目が閉じられた日時。
Microsoft.VSTS.Common.ClosedDate
コメント数
CommentCount		 Int32 作業項目の [ディスカッション ] セクションに追加されたコメントの数。
System.CommentCount
コミット
Committed		 String 要件がプロジェクトでコミットされているかどうかを示します。 有効な値は [はい] または [いいえ] です。 (CMMI プロセス)
Microsoft.VSTS.CMMI.Committed
CompletedDateSK Int32 作業項目が [完了] ワークフロー状態カテゴリに関連付けられたワークフロー状態に入ったときを格納する、Analytics によってキャプチャされたナビゲーション プロパティの日付。
CompletedOn ［ナビゲーション］ 作業項目がDate、organizationに対して定義されたタイム ゾーンの [完了] ワークフロー状態カテゴリに関連付けられたワークフロー状態に入った日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。
実績作業
CompletedWork		 Double タスクに費やされた作業量の測定結果。
Microsoft.VSTS.Scheduling.CompletedWork
作成者
CreatedBy
CreatedByUserSK		 UserSK 作業項目を作成したユーザーの名前。
Microsoft.VSTS.Common.CreatedBy
[作成日]
CreatedDate
CreatedDateSK		 DateTime 作業項目が作成された日付。organizationに対して定義されているタイム ゾーンで表されます。 フィルター処理と表示に一般的に使用されます。
Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 作業項目が作成された日付。organizationに対して定義されたタイム ゾーンで表YYYYMMDDされます。 外部ツールで関連エンティティを結合するために使用されます。
CreatedOn ［ナビゲーション］ organizationにDate対して定義されているタイム ゾーンで、作業項目が作成された日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。
サイクル時間の日数
CycleTimeDays		 Double サイクル時間は、最初に [進行中] または [解決済み] 状態カテゴリに入った後、完了状態カテゴリに入るまで計算されます。 詳細については、「 時間とサイクル時間のウィジェットを読み取るを参照してください。
規範
Discipline		 String タスクに割り当てられているアクティビティまたは作業分野の種類。 使用できる値は、 Analysis*、 Development、 Test、 User Education、 User Experience です。 (CMMI プロセス)
Microsoft.VSTS.Common.Activity
期限
DueDate		 DateTime 問題または作業項目が解決される予測期限。 (アジャイル プロセス)
Microsoft.VSTS.Scheduling.DueDate
作業
Effort		 Double 製品バックログ項目 (スクラム プロセス) または Issue (Basic プロセス) が実装する必要がある作業量の見積もり。
Microsoft.VSTS.Scheduling.Effort
完了日
FinishDate		 DateTime 作業項目が完了することをスケジュールで示す日付と時刻。
Microsoft.VSTS.Scheduling.FinishDate
発見されたビルド
FoundIn		 String リビジョンとも呼ばれる、バグが発見された製品ビルド番号。
Microsoft.VSTS.Build.FoundIn
InProgress 日付
InProgressDate		 DateTime 分析に保存された日付。作業項目が [進行中] 状態カテゴリに属する状態に移動された日時をキャプチャします。
InProgressDateSK Int32 作業項目が [進行中] 状態カテゴリに属する状態に移動された日付。これは、organizationに対して定義されているタイム ゾーンのようにYYYYMMDD表されます。 外部ツールで関連エンティティを結合するために使用されます。
統合ビルド
IntegrationBuild		 String コードが組み込まれた、または、バグが修正された製品ビルド番号。
Microsoft.VSTS.Build.IntegrationBuild
現在の状態
IsCurrent		 ブール型 値を に設定して、フィルター処理された作業項目セットの最新のスナップショットを表示するTrueデータのフィルター処理をサポートします。
、、および のエンティティ型WorkItemRevisionWorkItemBoardSnapshotに対してBoardLocation有効です。
1 日の最後のリビジョン
IsLastRevisionOfDay		 ブール型 スナップショット が にTrue設定された日の最後のリビジョンを表していることを示します。
期間の最終改訂
IsLastRevisionOfPeriod		 ブール型 に設定した場合、スナップショットが期間の最後のリビジョンをTrue表していることを示します。
問題点
Issue		 String 共有ステップが予想結果に関連付けられていることを示します。 使用できる値は [はい] と [いいえ] です。
Microsoft.VSTS.Common.Issue
リード タイムの日数
LeadTimeDays		 Double リード タイムは、作業項目の作成または 提案された 状態カテゴリの入力から 完了 状態カテゴリへの入力まで計算されます。 詳細については、「 時間とサイクル時間のウィジェットを読み取るを参照してください。
元の見積もり
OriginalEstimate		 Double タスクの完了に必要な作業量の測定結果。
Microsoft.VSTS.Scheduling.OriginalEstimate
親作業項目 ID
ParentWorkItemId		 Int32 親としてリンクされている作業項目を識別する一意の ID。 ロールアップ レポートを生成する場合に便利です。 [親] フィールドは、Azure DevOps Server 2020 以降のバージョンから使用できます。 次のエンティティ型に対して有効です。 WorkItemRevision と WorkItemです。
System.Parent
優先順位
Priority		 Int32 業務に関連付けた場合のバグ、懸案事項、タスク、またはテスト ケースの主観的な評価。 値には、 - 1、 2、または 3 が含まれます。
Microsoft.VSTS.Common.Priority
プロジェクト名
ProjectName		 ［ナビゲーション］ 作業項目が属するプロジェクトの名前。 詳細については、「 カレンダーの日付、プロジェクト、およびユーザーメタデータリファレンス、Project プロパティ」を参照してください。
System.TeamProject
ProjectSK GUID 作業項目が属するプロジェクトに割り当てられた GUID。
Rating
Reason		 String 星の数に基づくランキング システムで、項目がレビューアーから受け取る星の数 (フィードバック応答)数値はシステムに格納され、次のように書かれています:- 0 - 評価なし、 1 - Poor、 2 - Fair、 3 - Good、 4 - Very Good、 5 - Excellent。 次のエンティティ型に対して有効です。 WorkItemRevision と WorkItemです。
Microsoft.VSTS.Common.Rating
理由
Reason		 String 作業項目が現在の状態にある理由。 あるワークフロー状態から別のワークフロー状態への各遷移は、対応する理由に関連付けられます。
System.Reason
残存作業
RemainingWork		 Double タスクの完了までの残りの作業量の測定結果。
Microsoft.VSTS.Scheduling.RemainingWork
解決者
ResolvedBy
ResolvedByUserSK		 UserSK バグまたはユーザー ストーリーを解決したチーム メンバーの名前。
Microsoft.VSTS.Common.ResolvedBy
解決日
ResolvedDate		 DateTime バグまたはユーザー ストーリーが解決された日時。
Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 作業項目が解決された日付。organizationに対して定義されたタイム ゾーンで表YYYYMMDDされます。 外部ツールが関連エンティティを結合するために使用します。
ResolvedOn ［ナビゲーション］ organizationにDate対して定義されたタイム ゾーンで、作業項目が解決された日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。
解決理由
ResolvedReason		 String バグが解決された理由 (修正済みなど)。
Microsoft.VSTS.Common.ResolvedReason
Revision
Revision		 Int32 作業項目の履歴のリビジョンに割り当てられている番号。
System.Rev
更新日
RevisedDate		 DateTime 作業項目が変更または更新された日時。
RevisedDateSK Int32 作業項目が改訂された日付。organizationに対して定義されたタイム ゾーンで表YYYYMMDDされます。 外部ツールが関連エンティティを結合するために使用します。
RevisedOn ［ナビゲーション］ organizationにDate対して定義されたタイム ゾーンで、作業項目が変更された日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。
リスク
Risk		 Double ユーザー ストーリーを正常に完了することを主観的に評価した場合の相対的な不確実性。 有効な値は、 1 ~ 高、 2 - 中、 3 - 低です。
Microsoft.VSTS.Common.Risk
重大度
Severity		 Double プロジェクトに対するバグ、懸案事項、またはリスクの影響の主観的な評価。 有効な値には、 1 - Critical、 2 - High、 3 - Medium、 および 4 - Low が含まれます。
Microsoft.VSTS.Common.Severity
[サイズ]
Size		 Double 要件 (CMMI プロセス) が実装するために必要な作業量の見積もり。
Microsoft.VSTS.Scheduling.Size
スタック順位
StackRank		 Double バックログまたはボード上の項目のシーケンスをスタックまたは追跡するために使用されるシステムバックグラウンドプロセスによって割り当てられた数値。 (アジャイル、スクラム、および基本プロセス)
Microsoft.VSTS.Common.StackRank
[開始日]
StartDate		 DateTime 作業を開始するために作業項目に割り当てられた日付と時刻。
Microsoft.VSTS.Scheduling.StartDate
状態
State		 String 作業項目の現在の状態。 state の有効な値は、各種類の作業項目と、それに対して行われたカスタマイズに固有です。
System.State
状態カテゴリ
StateCategory		 String 状態カテゴリは、各ワークフローの状態をAzure Boardsして選択するダッシュボード ウィジェットの処理方法を決定します。 使用中の状態カテゴリには、 提案済み、 進行中、 解決済み、 削除済み、 完了があります。 詳細については、「 ワークフローの状態と状態カテゴリを使用する方法を参照してください。 エンティティ型に対 WorkItemRevision してのみ有効です。
状態の変更日
StateChangeDate		 DateTime State フィールドの値が変更された日時。
Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 作業項目の状態が変更された日付。organizationに対して定義されたタイム ゾーンで表YYYYMMDDされます。 外部ツールが関連エンティティを結合するために使用します。
StateChangeOn ［ナビゲーション］ organizationにDate定義されているタイム ゾーンで、作業項目の State が変更された日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。
ストーリー ポイント
StoryPoints		 Double ユーザー ストーリー (アジャイル プロセス) が実装するために必要な作業量の見積もり 。一般的に合計として集計されます。
Microsoft.VSTS.Scheduling.StoryPoints
タグ
TagNames		 String フィルター処理またはクエリを実行するために 1 つ以上の作業項目に割り当てられたタグのセミコロン区切りのリスト。
System.Tags
目標とする日
TargetDate		 DateTime 問題またはその他の作業項目が解決または完了する予測期限。
Microsoft.VSTS.Scheduling.TargetDate
テスト スイートの種類 String テスト スイートの種類を指定します。 有効な値は、 クエリ ベース、 要件ベース、 静的です。
Microsoft_VSTS_TCM_TestSuiteType
テスト スイートの種類 ID Int64 テスト スイート カテゴリに対応し、テスト スイートにのみ適用されるシステム割り当て番号。 割り当てられた値は、1 (静的)、2 (クエリベース)、および 3 (要件ベース) です。
Microsoft_VSTS_TCM_TestSuiteTypeId
時間の重要度
TimeCriticality		 Double 時間の経過と伴うビジネス価値の低下をキャプチャする主観的な測定単位。 値が大きいほど、そのエピックまたは機能が、値の小さい項目より本質的に時間的重要性が高いことを示します。
Microsoft.VSTS.Common.TimeCriticality
Title
Title		 String 作業項目の内容をまとめた簡単な説明。チーム メンバーはこの説明を参考にして、作業項目をリスト内の他の作業項目と区別できます。
System.Title
値の領域
ValueArea		 String エピック、機能、またはバックログ項目によって扱われる顧客価値の領域。 値には、 アーキテクチャ または ビジネスが含まれます。
Microsoft.VSTS.Common.ValueArea
ウォーターマーク
Watermark		 String 作業項目に加えられた変更をインクリメントするシステム管理フィールド。 次のエンティティ型に対して有効です。 WorkItemRevision と WorkItemです。
System.Watermark
作業項目 ID
WorkItemId		 Int32 作業項目に割り当てられる一意の識別子。 作業項目 ID は、すべてのプロジェクトと、organizationまたはプロジェクト コレクション内で一意です。
System.Id
WorkItemRevisionSK Int32 外部ツールが関連エンティティを結合するために使用する作業項目リビジョンの Analytics 一意キー。
作業項目の種類
WorkItemType		 String 作業項目の種類の名前。 作業項目の種類は、プロジェクトの作成時に使用されるプロセスに基づいて定義されます。 詳細については、「 プロセスとプロセス テンプレートについて」を参照してください。
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 ResolvedBy
ResolvedByUserSK, UserSK 		WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot
Teams Area、 BoardLocation、 Iteration、 WorkItemRevision、 WorkItemSnapshot、 WorkItemBoardSnapshot
タグ WorkItem、 WorkItemRevision、 WorkItemBoardSnapshot
プロジェクト Project
ProjectSK, ProjectSK 		Tag、 WorkItemBoardSnapshot、 WorkItemLink、 WorkItemRevision、 WorkItemSnapshot、 WorkItemTypeField、
処理 WorkItemRevision、 WorkItem、 WorkItemSnapshot
リビジョン WorkItem
リンク WorkItem
Children WorkItem
Parent WorkItem
子孫 WorkItem
Workitem WorkItemId WorkItemRevision

関数を予測する

WorkItem エンティティでは、次の 2 つの関数がサポートされています。 これらの関数は、選択した分析の組み込みレポートとウィジェットの予測傾向をサポートするために使用されます。

  • PredictTags
  • Predict

BoardLocation と WorkItemBoardSnapshot

次の表に示すプロパティは、特に明記されていない限り、次のエンティティ型に対して定義されます。 これらのフィールドを使用すると、チームのボード列、スイムレーン、またはバックログ レベル内の作業項目の状態に基づいて作業項目データをフィルター処理できます。

  • BoardLocation
  • WorkItemBoardSnapshot

エンティティ セットに対してクエリを実行する WorkItemBoardSnapshot 例については、「 累積フローダイアグラム (CFD) サンプル レポート」を参照してください。

[表示名]
Property name		 データの種類 説明
Reference name
ボード ID
BoardId		 GUID ボードに割り当てられた一意の GUID。 各チームは、1 つ以上のボードに関連付けられています。
ボード カテゴリ参照名
BoardCategoryReferenceName		 String ボードの設定に使用する作業項目の種類のカテゴリに割り当てられた名前。 たとえば、製品バックログ ボードは [要件] カテゴリに関連付けられています。 詳細については、 バックログまたはボードのカスタマイズ (継承プロセス) に関する記事を参照してください。
ボード名
BoardName		 String ボードに割り当てられた名前。 たとえば、 ストーリー、 バックログ アイテム、 機能、 エピックなどです。
ボード レベル
BoardLevel		 Int32 ボードの階層内の位置に基づいてボードに割り当てられた番号。
バックログの種類
BacklogType		 String バックログの種類の名前。 たとえば、イテレーション、要件、ポートフォリオなどです。
列名
ColumnName		 String 作業項目が現在割り当てられているボード列の名前 ( Active、 Closed、 Committed、 Done、その他のカスタム列ラベルなど)。
System.BoardColumn
列の順序
ColumnOrder		 Int32 ボード内のシーケンスに関してボード列に割り当てられた番号。
完了
Done		 Enumerated 列の分割位置を示します。 BoardColumnSplit の有効な値を以下に示します。
列項目の制限
ColumnItemLimit		 Int32 シーケンスに関してボード列に割り当てられた番号。
ボードが表示される
IsBoardVisible		 ブール型 チームがボードを表示するかどうかを示します。
列の分割
IsColumnSplit		 Boolean Doing と Done 列に列が分割されているかどうかを示します。これは、作業中の作業を示すためにボード上の Split 列で説明されています。
現在の状態
IsCurrent		 ブール型 値を に設定して、フィルター処理された一連の作業項目の最新のスナップショットを表示するデータのフィルター処理をサポートする Trueプロパティ。
既定のレーン
IsDefaultLane		 ブール型 作業項目が既定のスイムレーンに割り当てられていることを示すプロパティ (True) または割り当てなし (False)。
完了
IsDone		 Boolean 列内の Doing (False) または Done (True) への作業項目の現在の割り当て。 ボード列で分割列が有効になっている場合にのみ割り当てられます。
System.BoardColumnDone
レーン ID
LaneId		 GUID ボード スイム レーンに割り当てられた一意の GUID。 各チームは、ボードに 1 つ以上のスイム レーンを追加できます。 スイムレーンの詳細については、「 ボードでスイムレーンを使用してチームの作業を高速化するを参照してください。
レーン名
LaneName		 String ボード スイムレーンに割り当てられた名前。
System.BoardLane
レーンの順序
LaneOrder		 Int32 シーケンスの観点からボード スイムレーンに割り当てられた番号。

BoardColumnSplit 列挙メンバー

次の表に、列挙型のメンバー名を BoardColumnSplit 示します。この名前を使用すると、[ 実行 ] または [ 完了 ] ボード列の作業項目をフィルター処理できます。

メンバー名 値 表示名
Doing 0 実行中
Done 1 完了
Unknown 2 不明 (分割されていません)

チームのボード列の詳細については、次の記事を参照してください。

Areas

次のプロパティは、[エリア パス] フィールドに関連付けられている Areas エンティティ セットに対して有効です。 Area に関連付けられている代理キーには、 と がProjectSK含まれますAreaSK。 これらのプロパティを使用すると、エリア パスの割り当てに基づいて作業追跡データをフィルター処理またはレポートできます。

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
Number Int32 エリア パス ノードの作成時に割り当てられる整数値。
[奥行] Depth Int32 ルート レベルからの深さに基づいてエリア パスが定義されるレベル。
エリア ID AreaId GUID エリア パスの作成時に割り当てられる一意識別子。
エリア レベル 1 ~
エリア レベル 14		 AreaLevel1 から
AreaLevel14		 String エリア パスのノード レベルに関連付けられている名前。 最大 14 個の入れ子になったレベルがサポートされています。 たとえば、エリア レベル 1 は常にルート ノードとプロジェクト名に対応します。
領域の名前 AreaName String エリア パスの作成時に定義される名前。
エリア パス AreaPath String ルート ノードから始まるエリア パスの完全パス。

重要

  • Area パスの削除または Iteration Paths の再構成により、元に戻せないデータ損失が発生します。 たとえば、 Area Paths が変更されたチームのバーンダウンおよびバーンアップ ウィジェット グラフ、スプリント バーンダウン、ベロシティ グラフでは、正確なデータは表示されません。 履歴傾向グラフは、作業項目ごとに定義された エリア パス と Iteration Path を参照します。 一度削除すると、これらのパスの履歴データを取得することはできません。
  • 削除できるのは、作業項目で使用されなくなった領域パスと反復パスのみです。

Area エンティティ型と Areas エンティティ セットのナビゲーション プロパティには、 と がTeams含まれます。Project

Area パスの詳細については次の記事を参照してください。

イテレーション

次のプロパティは、イテレーション パス フィールドに関連付けられている Iterations エンティティ セットに対して有効です。 イテレーションに関連付けられている代理キーには、 と がProjectSK含まれますIterationSK。 これらのプロパティを使用して、イテレーション パスの割り当てに基づいて作業追跡データをフィルター処理またはレポートできます。

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
Number Int32 イテレーション パス ノードの作成時に割り当てられる整数値。
[奥行] Depth Int32 反復パスがルート レベルからの深さに基づいて定義されるレベル。
終了日 EndDate DateTime イテレーション パスに対して定義された終了日。
IsEnded IsEnded ブール型 True に設定すると、イテレーション パスの終了日が過去であることを示します。
イテレーション ID IterationId GUID イテレーション パスの作成時に割り当てられる一意の識別子。
イテレーション レベル 1 から
イテレーション レベル 14		 IterationLevel1 から
IterationLevel14		 String 反復パスのノード レベルに関連付けられている名前。 最大 14 個の入れ子になったレベルがサポートされています。 たとえば、イテレーション レベル 1 は常にルート ノードとプロジェクト名に対応します。
イテレーション名 IterationName String イテレーション パスの作成時に定義された名前。
イテレーション パス IterationPath String ルート ノードから始まるイテレーション パスの完全パス。 このイテレーションは、プロジェクト階層で有効なノードである必要があります。
System.IterationPath
[開始日] StartDate DateTime イテレーション パスに対して定義された開始日。

重要

  • Area パスの削除または Iteration Paths の再構成により、元に戻せないデータ損失が発生します。 たとえば、 Area Paths が変更されたチームのバーンダウンおよびバーンアップ ウィジェット グラフ、スプリント バーンダウン、ベロシティ グラフでは、正確なデータは表示されません。 履歴傾向グラフは、作業項目ごとに定義された エリア パス と Iteration Path を参照します。 一度削除すると、これらのパスの履歴データを取得することはできません。
  • 削除できるのは、作業項目で使用されなくなった領域パスと反復パスのみです。

Iteration エンティティ型と Iterations エンティティ セットのナビゲーション プロパティには、 と がTeams含まれますProject。

Iteration パスの詳細については、次の記事を参照してください。

プロセス

次のプロパティは、 Process エンティティ型と Process エンティティ セットに対して有効です。 Process に関連付けられている代理キーには、、ProjectSK、および TeamSKが含まれますProcessSK。 これらのプロパティを使用すると、プロジェクトまたはチームによって使用される作業項目の種類に基づいて、作業追跡データをフィルター処理またはレポートできます。

Note

Process エンティティの種類と Process エンティティ セットは、v-2.0、v3.0-preview、および v4.0-preview バージョンの Analytics でサポートされています。

これらのプロパティを使用して、バックログ レベルに基づいて作業追跡データをフィルター処理できます

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
ProjectSK GUID プロセスに関連付けられているプロジェクト キー。
TeamSK GUID プロセスに関連付けられているチーム キー。
バックログ カテゴリ参照名 BacklogCategoryReferenceName String 作業項目の種類に関連付けられているバックログに割り当てられたカテゴリ参照名。 たとえば、Microsoft.EpicCategory、、Microsoft.FeatureCategoryMicrosoft.RequirementCategory、 Microsoft.TaskCategoryなどです。
バックログ名 BacklogName ブール型 作業項目の種類に関連付けられているバックログに割り当てられた参照名
バックログの種類 BacklogType GUID イテレーション パスの作成時に割り当てられる一意識別子。
バックログ レベル BacklogLevel String 作業項目の種類に関連付けられているバックログ レベルを指定します。 作業項目の種類がバックログ レベルに関連付けられていない場合、返される値は です null。
作業項目の種類 WorkItemType String 作業項目の種類に対して定義された名前。
バックログがある HasBacklog String 作業項目の種類がバックログに属しているかどうかを示します。
非表示の型 IsHiddenType ブール型 作業項目の種類が無効になっているかどうかを示します。
バグの種類 IsBugType ブール型 作業項目の種類がバグ カテゴリに属しているかどうかを示します。
削除済み IsDeleted ブール型 作業項目の種類が削除されたかどうかを示します。

プロセス バックログと作業項目の種類の詳細については、次の記事を参照してください。

カスタム作業項目の種類とカスタム バックログ カテゴリ

カスタム作業項目の種類のデータは、Analytics サービスに自動的に追加されます。

カスタム作業項目の種類とバックログ レベルが定義されると、カスタム カテゴリが作成されます。 Custom_ はカテゴリ GUID の前に追加されます。 たとえば、ポートフォリオ バックログを含む ポートフォリオ カスタム作業項目の種類の場合、 などの Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000カスタム カテゴリに GUID が割り当てられます。

タグ

次のプロパティは、 Tags エンティティ セットに対して有効です。 Tag に関連付けられているサロゲート キーには、 と がProjectSK含まれますTagSK。 ナビゲーション プロパティには、 とその参照制約 が含まれますProjectProjectSK。 タグの使用の詳細については、「 作業項目タグを追加してリストとボードを分類およびフィルター処理するを参照してください。

これらのプロパティを使用して、作業追跡データをフィルター処理またはレポートできます。

[表示名] 名前 データの種類 説明
タグ ID TagId GUID タグの作成時にタグに割り当てられる一意の ID。
タグ名 TagName String タグ名。

Teams

次のプロパティは、 Team エンティティの種類と Teams エンティティ セットに対して有効です。 Team に関連付けられている代理キーには、 と がProjectSK含まれますTeamSK。 これらのプロパティを使用して、チームの割り当てに基づいて作業追跡データをフィルター処理またはレポートできます。 チームの使用と追加の詳細については、「 チームとアジャイル ツールについて」および「チーム を 作成または追加する」を参照してください。

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
チーム ID TeamId GUID チームの作成時にチームに割り当てられた一意の ID。
チーム名 TeamName String チーム名。

Teams エンティティ セットのナビゲーション プロパティには、、Areas、および がIterations含まれますProjects。

次のプロパティは、 WorkItemLinks エンティティ セットに対して有効です。 プロパティ参照サロゲート キーは です WorkItemLinkSK。 WorkItemLinks にクエリを実行して、親/子、関連、先行/後続リンク、またはその他のリンクの種類についてレポートします。

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
WorkItemLinkSK Int32 エンティティに割り当てられた WorkItemLink 代理キー。
[作成日] CreatedDate GUID リンクが作成された日付。
解説 Comment String リンクの作成時に追加されたコメント。
削除日 DeletedDate String リンクが削除された日付。
リンクの種類 ID LinkTypeId Int32 リンク先の作業項目に割り当てられた ID。
リンクの種類名 LinkTypeName String リンクの種類に割り当てられたフレンドリ名。
リンクの種類の参照名 LinkTypeReferenceName String リンクの種類に割り当てられた参照名。
リンクの種類が非巡回である LinkTypeIsAcyclic ブール型 リンクの種類を示すリンク型属性の値は、値が True に設定されている場合に循環リレーションシップを許可します。 たとえば、ツリー型のリンクは循環リレーションシップを制限します。
リンクの種類が方向 LinkTypeIsDirectional ブール型 リンクの種類が方向であることを示すリンクの種類属性の値。 方向リンクの種類は、前方コンポーネントと逆方向コンポーネントとのペアで定義されます。
ソース作業項目 ID SourceWorkItemId Int32 リンク先のソース作業項目に割り当てられた ID。
ターゲット作業項目 ID TargetWorkItemId Int32 リンク先の作業項目に割り当てられた ID。

WorkItemLink エンティティ型のナビゲーション プロパティには、、SourceWorkItem、および がTargetWorkItem含まれますProjects。

リンクとリンクの種類の詳細については、次の記事を参照してください。

WorkItemTypeFields

次のプロパティは、 WorkItemTypeFields エンティティ セットに対して有効です。 プロパティ参照キーは、 FieldName、 ProjectSK、および WorkItemTypeです。

[表示名] 名前 データの種類 説明
フィールド名 FieldName String システムまたは作成時にフィールドに割り当てられたフレンドリ名。
フィールド参照名 FieldReferenceName String システムまたはユーザー設定フィールドの作成時にフィールドに割り当てられた参照名。
フィールドの型 FieldType String フィールドに割り当てられたデータ型。
作業項目の種類 WorkItemType String フィールドが定義されている作業項目タイプの名前。

ナビゲーション プロパティには、 が含まれます Project。

プロジェクトに対して定義されているすべてのフィールドのインデックスについては、「 作業項目フィールドのフィールドの説明」を参照してください。 詳細については、次の記事を参照してください。

カスタム プロパティ

カスタム フィールドは、カスタム プロパティとして Analytics サービスに自動的に追加されます。 Custom_ または Custom. がプロパティ名の前に付加されます。 「Analytics の OData クエリを作成する」の説明に従ってコレクションのメタデータを確認し 、URL コンポーネントを使用してメタデータにクエリを実行します。 次の例では、ユーザー設定フィールド 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>