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実行します。 詳細については、「 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 使用して、特定の作業項目のすべてのリビジョンを読み込みます。 クエリは、フィルター処理する作業項目に対して、現在のリビジョンを含むすべての履歴作業項目のリビジョンを返します。 削除された作業項目は含まれません。
複数のエンティティ型の共有プロパティ
分析ビューで選択できるプロパティは、通常の作業追跡フィールドに対応し、[サイクル時間の日] や [リード タイムの日] などの [分析] プロパティを選択します。 これらのプロパティは、特に指定がない限り、次の表に示すほとんどのプロパティが、次のエンティティ型に対して定義されています。
WorkItemWorkItemRevisionWorkItemSnapshotWorkItemBoardSnapshot
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 |
アクティブ化した人ActivatedByActivatedByUserSK |
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 |
エリア パスAreaPathAreaSK |
String | 作業項目を製品機能区分またはチーム区分に分類します。 この区分は、プロジェクト階層で有効なノードである必要があります。System.AreaPath |
割当先 AssignedToAssignedToUserSK |
UserSK | 現在、作業項目を所有しているチーム メンバーの名前。System.AssignedTo |
自動テスト ID AutomatedTestId |
String | テスト ケースを自動化するテストの IDMicrosoft.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 |
変更者ChangedByChangedByUserSK |
UserSK | 作業項目を最後に変更したユーザーの名前。System.ChangedBy |
Changed Date (変更日)ChangedDate |
DateTime | 作業項目が変更された日時。System.ChangedDate |
ChangedDateSK |
Int32 | 作業項目が変更された日付。organizationに対して定義されているタイム ゾーンで表YYYYMMDDされます。 外部ツールで関連エンティティを結合するために使用されます。 |
ChangedOn |
［ナビゲーション］ | organizationにDate対して定義されているタイム ゾーンで、作業項目が変更された日付のエンティティへのナビゲーション プロパティ。 ステートメント内のエンティティからプロパティを Date 参照するために一般的に groupby 使用されます。 |
クローズ者ClosedByClosedByUserSK |
UserSK | 作業項目を終了した人物の名前。 Microsoft.VSTS.Common.ClosedBy |
終了日ClosedDateClosedDateSKClosedOn |
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 |
作成者CreatedByCreatedByUserSK |
UserSK | 作業項目を作成したユーザーの名前。 Microsoft.VSTS.Common.CreatedBy |
[作成日]CreatedDateCreatedDateSK |
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 |
RevisionRevision |
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 |
作業項目 IDWorkItemId |
Int32 | 作業項目に割り当てられる一意の識別子。 作業項目 ID は、すべてのプロジェクトと、organizationまたはプロジェクト コレクション内で一意です。System.Id |
WorkItemRevisionSK |
Int32 | 外部ツールが関連エンティティを結合するために使用する作業項目リビジョンの Analytics 一意キー。 |
作業項目の種類 WorkItemType |
String | 作業項目の種類の名前。 作業項目の種類は、プロジェクトの作成時に使用されるプロセスに基づいて定義されます。 詳細については、「 プロセスとプロセス テンプレートについて」を参照してください。 System.WorkItemType |
ナビゲーション プロパティ
OData のナビゲーション プロパティは、別のエンティティを指すエンティティの参照属性です。 次の表に、ナビゲーション プロパティ、参照制約、および有効なエンティティ型の概要を示します。
| 表示名 | 名前 参照制約とプロパティ |
エンティティ型に対して有効 |
|---|---|---|
ChangedOnChangedDateSK, DateSK |
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot |
|
ClosedOn ClosedDateSK, DateSK |
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot |
|
CreatedOnCreatedDateSK, DateSK |
WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot |
|
ResolvedOnResolvedDateSK, DateSK |
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot |
|
StateChangeOnStateChangeDateSK, DateSK |
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot |
|
InProgressOnInProgressDateSK, DateSK |
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot |
|
CompletedOnCompletedDateSK, DateSK |
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot |
|
ChangedOnChangedDateSK, DateSK |
WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot |
|
RevisedOnRevisedDateSK, 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 つの関数がサポートされています。 これらの関数は、選択した分析の組み込みレポートとウィジェットの予測傾向をサポートするために使用されます。
PredictTagsPredict
BoardLocation と WorkItemBoardSnapshot
次の表に示すプロパティは、特に明記されていない限り、次のエンティティ型に対して定義されます。 これらのフィールドを使用すると、チームのかんばんボード列、スイムレーン、またはバックログ レベル内の作業項目の状態に基づいて作業項目データをフィルター処理できます。
BoardLocationWorkItemBoardSnapshot
エンティティ セットに対してクエリを実行する WorkItemBoardSnapshot 例については、「 累積フローダイアグラム (CFD) サンプル レポート」を参照してください。
[表示名]Property name |
データの種類 | 説明Reference name |
|---|---|---|
ボード ID BoardId |
GUID | かんばんボードに割り当てられた一意の GUID。 各チームは、1 つ以上のかんばんボードに関連付けられています。 |
ボード カテゴリ参照名BoardCategoryReferenceName |
String | かんばんボードの設定に使用される作業項目の種類のカテゴリに割り当てられた名前。 たとえば、製品バックログ ボードは [要件] カテゴリに関連付けられています。 詳細については、「 バックログまたはボードのカスタマイズ (継承プロセス)」を参照してください。 |
ボード名 BoardName |
String | かんばんボードに割り当てられた名前。 たとえば、 ストーリー、 バックログ アイテム、 機能、 エピックなどです。 |
ボード レベルBoardLevel |
Int32 | かんばんボードの階層内の位置に基づいてかんばんボードに割り当てられた番号。 |
バックログの種類 BacklogType |
String | バックログの種類の名前。 たとえば、イテレーション、要件、ポートフォリオなどです。 |
列名ColumnName |
String | 作業項目が現在割り当てられているかんばんボード列の名前 ( アクティブ、 クローズ、 コミット済み、 完了、その他のカスタム列ラベルなど)。 System.BoardColumn |
列の順序ColumnOrder |
Int32 | かんばんボード内の順序に関してかんばんボード列に割り当てられた番号。 |
完了 Done |
Enumerated | 列の分割位置を示します。 BoardColumnSplit の有効な値を以下に示します。 |
列項目の制限ColumnItemLimit |
Int32 | 順序に関してかんばんボード列に割り当てられた番号。 |
ボードが表示される IsBoardVisible |
ブール型 | チームがボードを表示するかどうかを示します。 |
列の分割IsColumnSplit |
ブール型 | 「かんばんボードの列を分割して進行中の作業を表示する」で説明されているように、列が [実行中] 列と [完了] 列に分割されているかどうかを示します。 |
現在の状態 IsCurrent |
ブール型 | 値を に設定して、フィルター処理された一連の作業項目の最新のスナップショットを表示するデータのフィルター処理をサポートする Trueプロパティ。 |
既定のレーン IsDefaultLane |
ブール型 | 作業項目が既定のスイムレーンに割り当てられていることを示すプロパティ (True) または割り当てなし (False)。 |
完了 IsDone |
ブール型 | かんばん列内の 作業 項目の現在の割り当て (False) または 完了 (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 エンティティ型と Areas エンティティ セットのナビゲーション プロパティには、 と がTeams含まれます。Project
エリア パスの詳細については、次の記事を参照してください。
イテレーション
次のプロパティは、イテレーション パス フィールドに関連付けられている 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 | イテレーション パスに対して定義された開始日。 |
重要
エリア パスを削除したり、反復パスを再構成したりすると、データが失われ、元に戻すことはできません。 たとえば、 エリア パス が変更されたチームのバーンダウンまたはバーンアップ ウィジェット グラフ、スプリント バーンダウン、ベロシティ グラフは、正しいデータを反映しません。 履歴傾向グラフは、各作業項目の過去のポイントで定義されている エリア パス と 反復パス を参照します。 エリア パスまたは反復パスが削除されると、その履歴データを取得できません。
Iteration エンティティ型と Iterations エンティティ セットのナビゲーション プロパティには、 と がTeams含まれますProject。
イテレーション パスの詳細については、次の記事を参照してください。
プロセス
次のプロパティは、 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
次のプロパティは、 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>
関連記事
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示