次の方法で共有


Test Plans Analytics のメタデータ リファレンス

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

Analytics サービスは、すべての Azure DevOps テスト アクティビティのすべてのデータを収集します。 Azure Test Plans では、計画済みテストと探索的テストの定義と実行がサポートされます。 また、Azure Pipelines では、継続的インテグレーション/継続的配置 (CI/CD) ワークフローを使用して自動テストを実行することもできます。

Azure DevOps テストを初めて使用する場合は、次の記事を参照することをお勧めします。

この記事で提供されるメタデータ情報では、すべての Azure DevOps テスト アクティビティでサポートされるエンティティ、プロパティ、および列挙型について説明します。

Note

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

エンティティ セットとエンティティ型

Analytics for Test Plan データのクエリを実行するには、次の表で説明する 1 つ以上のエンティティ型とエンティティ セットを使用します。

Note

Azure DevOps テストの分析は、 v3.0-preview および v4.0-preview バージョンでサポートされています。
分析では、テスト関連のすべての作業項目が作業項目として格納されます。 Azure Boards Analytics のWork 追跡メタデータ リファレンス で説明されている作業追跡エンティティを使用して、このデータに関するレポートのクエリと生成を行うことができます

EntitySet EntityType 説明
テスト テスト テスト名やテスト所有者など、テスト ケースのプロパティ。 テスト ケースの定義の詳細については、 手動テスト ケースの作成を参照してください。
TestConfigurations TestConfiguration テスト 計画の構成情報。 テストの構成の詳細については、「 異なる構成のテストを参照してください。
TestPoints TestPoint テスト ポイントの実行情報。 テスト ポイントは、テスト ケース、テスト スイート、構成、テスターの一意の組み合わせです。 サンプル レポートについては、 Progress 状態のサンプル レポートを参照してください。
TestPointHistorySnapshot TestPointHistorySnapshot (複合)TestRun に関連付けられている特定のテストの個々の実行結果。 サンプル レポートについては、 Manual テスト実行傾向のサンプル レポートを参照してください。
TestResults TestResult TestRun に関連付けられた特定の Test に対する個々の実行結果。
TestResultsDaily TestResultDaily TestResult 実行の毎日のスナップショット集計。Test でグループ化されます (TestRun ではありません)。 サンプル レポートについては、 概要傾向のサンプル レポートを参照してください。
TestRuns TestRun パイプラインで実行されるテストの集計されたテスト結果を含む実行情報。
TestSuites TestSuite テスト スイートの情報。 テスト スイートの定義の詳細については、「 テスト 計画とテスト スイートの作成」を参照してください

テスト

次のプロパティは、 Test エンティティ型と Tests エンティティ セットに対して有効です。 サロゲート キーが TestSK

ナビゲーション プロパティには、 とその参照制約 が含まれますProjectProjectSK

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
コンテナー名 ContainerName String パイプライン内のテスト タスクを含むジョブ コンテナーの名前。
完全修飾テスト名 FullyQualifiedTestName String テスト用に作成された名前。 完全修飾名の形式は、文字制限が 512 の Namespace.Testclass.Methodname に対応します。 テストがデータ ドリブンであり、パラメーターがある場合、文字制限にはパラメーターが含まれます。
優先順位 Priority Int32 テストの重要性や重要度を指定します。 優先順位は通常、テスト コードの属性として指定されます。
テスト ケース参照 ID TestCaseReferenceId Int32 テスト ケースに割り当てられた番号 (ID ではありません)。
テスト名 TestName String テストの名前。
テスト所有者 TestOwner String テストまたはテスト実行の所有者。 通常、テスト所有者はテスト コードの属性として指定されます。 サポート テスト結果形式の Owner 属性のマッピングを表示するには テスト結果の公開タスクを参照してください。

TestConfigurations

テスト構成では、「 異なる構成をテストするで説明されているように、テストを実行するさまざまな環境を指定します。

次のプロパティは、 TestConfiguration エンティティ型と TestConfigurations エンティティ セットとそのサロゲート キー TestConfigurationSKに対して有効です。

[表示名] 名前 データの種類 説明
テスト構成 ID TestConfigurationId Int32 テスト ケースに割り当てられた番号 (ID ではありません)。
テスト構成名 Name String テスト構成に割り当てられた名前。
テスト構成の状態 State String テスト構成の状態 (アクティブまたは非アクティブ)。

ナビゲーション プロパティには、 とその参照制約 が含まれますProjectProjectSK

TestPoints

テスト ポイントは、テスト ケース、テスト スイート、構成、テスターの一意の組み合わせです。 次のプロパティは、 TestPoint EntityType および TestPoints EntitySet に対して有効です。 サロゲート キーが TestPointSK

[表示名] 名前 データの種類 説明
AssignedToUserSK GUID テスト ポイントに関連付けられているテスト担当者に割り当てられた GUID。
TesterUserSK GUID テスト ポイントに関連付けられているテスト担当者に割り当てられた GUID。
Automation の状態 AutomationStatus Enumerated 自動、未自動化、計画済みなどのテスト ケースの状態。 Microsoft.VSTS.TCM.AutomationStatus 作業項目フィールドに対応します。
Changed Date (変更日) ChangedDate DateTime テスト ポイントが最後に変更された日時。
最終結果の状態 LastResultState Enumerated 保留中、キューに入った、進行中など、テスト ポイントの状態。 有効な値は、 TestResultState の一覧に示されています。
優先順位 Priority Int32 関連付けられているテスト ケースに割り当てられた優先度。
テスト ケース ID TestCaseId Int32 関連付けられているテスト ケースに割り当てられた作業項目 ID。
テスト構成 ID TestConfigurationId Int32 関連付けられているテスト構成に割り当てられた番号。
テスト 計画 ID TestPlanId Int32 関連付けられているテスト 計画に割り当てられた作業項目 ID。
テスト結果の結果 LastResultOutcome Enumerated 最後のテスト結果を指定します。 有効な値は、 TestOutcome の一覧に示されています。
Test Suite Id TestSuiteId Int32 関連付けられているテスト スイートに割り当てられた作業項目 ID。

ユーザー インターフェイスを使用してテスト ポイントを確認するには、「 手動テストの実行、結果の保存、セッションの終了、結果の確認を参照してください。

次の表に、 TestPoint エンティティ型と TestPoints エンティティ セットのナビゲーション プロパティを示します。

表示名 名前 参照制約 Referenced プロパティ
ChangedOn ChangedDateSK DateSK
割り当て先 AssignedTo AssignedToUserSK UserSK
Project Project ProjectSK ProjectSK
テスト ケースの作業項目 TestCase TestCaseId WorkItemId
Test Configuration TestConfiguration TestConfigurationSK TestConfigurationSK
テスト スイート TestSuite TestSuiteSK TestSuiteSK
テスト担当者のユーザー名 Tester TesterUserSK UserSK

TestResultState 列挙型メンバー

テスト結果は、次の表に示す、 TestResultState 列挙型の 6 つの状態のいずれかになります。

メンバー名 表示名
None 0 なし
Pending 1 保留
Queued 2 キュー登録
InProgress 3 進行中
Paused 4 一時停止
Completed 5 完了済み

TestOutcome 列挙型のメンバー

テストの 15 個の結果を次の表に示します。メンバーは、 TestOutcome 列挙型に対して定義されています。

メンバー名 表示名称 説明
Unspecified 0 指定されていません。
None 1 None
Passed 2 成功 テストが正常に実行されました。
Failed 3 Failed 目的の結果を満たしていないテスト。
Inconclusive 4 結果不確定 明確な結果を得ずにテストします。
Timeout 5 タイムアウト 指定したしきい値を超えるテスト実行時間。
Aborted 6 Aborted 不適切なコードや環境の問題など、内部または外部の要因により、テストの実行が突然終了しました。
Blocked 7 ブロック済み
NotExecuted 8 未実行 実行のためにスキップ済みとしてマークされたテスト。
Warning 9 警告
Error 10 エラー
NotApplicable 11 適用外
Paused 12 一時停止
InProgress 13 進行中
NotImpacted 14 影響を受けず パイプラインをトリガーしたコード変更の影響を受けず、テストします。

TestPointHistorySnapshot

次のプロパティは、 TestPointHistorySnapshot エンティティ セットに対して有効です。 代理キーには、 TestPointSKDateSKが含まれます。

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
AssignedToUserSK GUID テスト作業項目に割り当てられた GUID。
IsLastDayOfPeriod Enumerated データをフィルター処理して、日、週、月、年などの異なる期間で 1 日が終了するかどうかを判断するために使用します。 有効な値を次に示します: Period 列挙型メンバー
TesterUserSK GUID テスト ポイントに関連付けられているテスト担当者に割り当てられた GUID。
TestConfigurationSK Int32 関連付けられているテスト構成に割り当てられたキー。
Automation の状態 AutomationStatus Enumerated 自動、未自動化、計画済みなどのテスト ケースの状態。 Microsoft.VSTS.TCM.AutomationStatus 作業項目フィールドに対応します。
優先順位 Priority Int32 関連付けられているテスト ケースに割り当てられた優先度。
テスト ケース ID TestCaseId Int32 関連付けられているテスト ケースに割り当てられた作業項目 ID。
テスト構成 ID TestConfigurationId Int32 関連付けられているテスト構成に割り当てられた番号。
テスト 計画 ID TestPlanId Int32 関連付けられているテスト 計画に割り当てられた作業項目 ID。
テスト結果の結果 ResultOutcome Enumerated 最後のテスト結果を指定します。 有効な値は、 TestOutcomeに一覧表示されます。
Test Suite Id TestSuiteId Int32 関連付けられているテスト スイートに割り当てられた作業項目 ID。

次の表に、 TestPointHistorySnapshot エンティティ型と TestPointHistorySnapshot エンティティ セットのナビゲーション プロパティを示します。

表示名 名前 参照制約 Referenced プロパティ
Date DateSK DateSK
割り当て先 AssignedTo AssignedToUserSK UserSK
Project Project ProjectSK ProjectSK
テスト ケースの作業項目 TestCase TestCaseId WorkItemId
Test Configuration TestConfiguration TestConfigurationSK TestConfigurationSK
テスト スイート TestSuite TestSuiteSK TestSuiteSK
テスト担当者のユーザー名 Tester TesterUserSK UserSK

TestResults

テスト結果は、特定の結果と詳細を持つテスト ケースの実行の 1 つのインスタンスに対応します。

テストの実行は、テストを手動で実行するか、パイプライン定義内にテスト タスクを含めると発生します。 詳細については、「 .NET Core アプリのビルド、テスト、デプロイ、テストの実行に関するページを参照してください。

次のプロパティは、 TestResults エンティティ セットに対して有効です。 サロゲート キーが TestResultSK

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
完了日 CompletedDate DateTime テスト結果の実行が完了した日時。
期間 (秒) DurationSeconds 10 進法 テストの実行にかかった秒数。
フレーキーです IsFlaky Boolean テストが不安定 (True) またはマークされていない (False) かどうかを示します。 不安定なテストとは、コードやテストの変更など、明らかな理由なく断続的に失敗するテストです。**** 詳細については、「 不安定なテストの管理」を参照してください
リリース ID ReleaseId Int32 テスト結果に関連付けられているリリースに割り当てられた番号。
リリース環境 ID ReleaseEnvironmentId Int32 テスト結果に関連付けられているリリース環境に割り当てられた数。
リリース パイプライン ID ReleasePipelineId Int32 テスト結果に関連付けられているリリース パイプラインに割り当てられた数。
リリース ステージ ID ReleaseStageId Int32 テスト結果に関連付けられているリリース ステージに割り当てられた数。
開始日 StartedDate DateTime テスト結果が実行を開始した日時。
テスト結果 ID TestResultId Int32 テスト結果に割り当てられた数。
テスト実行 ID TestRunId Int32 テストの実行に割り当てられた数。
テスト実行の種類 TestRunType Enumerated 手動または自動のテストの種類かどうかを示します。 有効な値は、 TestRunType の一覧に示されています。
テスト結果 Outcome Enumerated テストの実行結果。 テスト結果には、中止、ブロック、エラー、失敗、結果不確定、進行中、なし、該当なし、実行なし、影響を受けない、合格、一時停止、タイムアウト、未指定、警告 の 15 個の結果があります。 有効な値は、 TestOutcome の一覧に示されています。
Workflow Workflow Enumerated パイプライン ワークフローの種類。 有効な値は、 SourceWorkflow の一覧に示されています。

次の表に、 TestResult エンティティ型に対して有効なナビゲーション プロパティを示します。

名前 参照制約 Referenced プロパティ
CompletedOn CompletedDateSK DateSK
StartedOn StartedDateSK DateSK
Branch BranchSK BranchSK
Project ProjectSK ProjectSK
Pipeline PipelineSK PipelineSK
PipelineRun PipelineRunSK PipelineRunSK
Test TestSK TestSK
TestRun TestRunSK TestRunSK

SourceWorkflow 列挙型のメンバー

次の表に、 SourceWorkflow 列挙型に定義されているメンバーを示します。

[表示名] メンバー名
ビルド Build 1
リリース Release 2
手動 Manual 3

TestRunType 列挙型のメンバー

次の表に、 SourceWorkflow 列挙型に定義されているメンバーを示します。

メンバー名 表示名
Automated 1 自動化
Manual 2 手動

TestResultsDaily

次のプロパティは、 TestResultsDaily エンティティ セットに対して有効です。 サロゲート キーはTestResultsDailySKです。

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
リリース パイプライン ID ReleasePipelineId Int32 関連付けられているリリース パイプラインに割り当てられた番号。
リリース ステージ ID ReleaseStageId Int32 関連付けられているリリース パイプライン ステージに割り当てられた数。
結果の中止された数 ResultAbortedCount Int32 毎日のテスト結果に対して Aborted として報告されるテスト結果の数。
結果ブロック数 ResultBlockedCount Int32 毎日のテスト結果に対して Blocked として報告されるテスト結果の数。
結果の数 ResultCount Int32 報告されたテスト結果の合計数。
結果の継続時間 (秒) ResultDurationSeconds 10 進法 テスト結果の実行に必要な秒数。
結果エラー数 ResultErrorCount Int32 毎日のテスト結果の Error として報告されたテスト結果の数。
結果の失敗数 ResultFailCount Int32 毎日のテスト結果に対して Failed として報告されたテスト結果の数。
結果の不安定な数 ResultFlakyCount Int32 不安定な結果の数。 不安定なテストは、コードやテストの変更など、明らかな理由なしで断続的に失敗するテストです。 詳細については、「 不安定なテストを管理するを参照してください。
結果の不確定数 ResultInconclusiveCount Int32 毎日のテスト結果に対して Inconclusive として報告されたテスト結果の数。
結果のパス数 ResultPassCount Int32 毎日のテスト結果の Passed として報告されたテスト結果の数。
結果なしカウント ResultNoneCount Int32 毎日のテスト結果に対して None として報告されたテスト結果の数。
結果のタイムアウト数 ResultTimeoutCount Int32 毎日のテスト結果の Timeout として報告されるテスト結果の数。
結果が実行されない数 ResultNotExecutedCount Int32 毎日のテスト結果に対して 実行 として報告されるテスト結果の数。
結果の警告の数 ResultWarningCount Int32 毎日のテスト結果に対して Warning として報告されたテスト結果の数。
結果が適用されない数 ResultNotApplicableCount Int32 毎日のテスト結果に対して 該当なし として報告されたテスト結果の数。
影響を受けなかった結果の数 ResultNotImpactedCount Int32 毎日のテスト結果の 影響を受けません として報告されたテスト結果の数。
結果の継続時間 (秒) ResultDurationSeconds 10 進法 テスト結果が完了するまでにかかった秒数。
開始日 StartedDate String テスト結果の開始日時。
テスト実行の種類 TestRunType Enumerated 手動または自動のテストの種類かどうかを示します。 有効な値は、 TestRunType の下に表示されます。
Workflow Workflow Enumerated パイプライン ワークフローの種類。 有効な値は、 SourceWorkflow の下に一覧表示されます。

次の表に、 TestResultDaily エンティティ型に対して有効なナビゲーション プロパティを示します。

名前 参照制約 Referenced プロパティ
Branch BranchSK BranchSK
Date StartedDateSK DateSK
Pipeline PipelineSK PipelineSK
Project ProjectSK ProjectSK
Test TestSK TestSK

TestRuns

テストの実行は、テストを手動で実行するか、パイプライン定義内にテスト タスクを含めると発生します。 詳細については、「 .NET Core アプリのビルド、テスト、デプロイ、テストの実行に関するページを参照してください。

次のプロパティは、 TestRuns とそのサロゲート キー TestRunSKに対して有効です。

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
詳細あり HasDetail Boolean テストの実行の詳細を指定するかどうかを示します (True) かどうか (False)。
自動化されています IsAutomated Boolean テストの実行の詳細を指定するかどうかを示します (True) かどうか (False)。
優先順位 Priority Int32 パイプライン タスクに割り当てられたバージョン。
完了日 CompletedDate DateTime テストの実行またはテスト結果の完了の日時。
リリース ID ReleaseId Int32 関連付けられているリリース定義に割り当てられた番号。
リリース環境 ID ReleaseEnvironmentId Int32 関連付けられているリリース環境に割り当てられた番号。
リリース パイプライン ID ReleasePipelineId Int32 関連付けられているリリース パイプラインに割り当てられた番号。
リリース ステージ ID ReleaseStageId Int32 関連付けられているリリース パイプライン ステージに割り当てられた数。
結果の中止された数 ResultAbortedCount Int32 毎日のテストの実行またはテスト結果に対して Aborted として報告されるテスト結果の数。
結果ブロック数 ResultBlockedCount Int32 毎日のテストの実行またはテスト結果の Blocked として報告されるテスト結果の数。
結果の数 ResultCount Int32 報告されたテスト結果の合計数。
結果の継続時間 (秒) ResultDurationSeconds 10 進法 テストの実行に必要な秒数。
結果エラー数 ResultErrorCount Int32 テストの実行またはテスト結果の Error として報告されるテスト結果の数です。
結果の失敗数 ResultFailCount Int32 毎日のテストの実行またはテスト結果に対して Failed として報告されたテスト結果の数。
結果の不安定な数 ResultFlakyCount Int32 不安定としてマークされたテスト結果の数。 不安定なテストとは、コードやテストの変更など、明らかな理由なしで断続的に失敗するテストです。 詳細については、「 不安定なテストを管理するを参照してください。
結果の不確定数 ResultInconclusiveCount String 毎日のテストの実行またはテスト結果に対して Inconclusive として報告されたテスト結果の数。
結果のパス数 ResultPassCount Int32 Passedとして報告されたテストの結果の数。テストの実行またはテストの結果が毎日行われます。
結果のタイムアウト数 ResultTimeoutCount Int32 テストの実行またはテスト結果の Timeout として報告される毎日のテスト結果の数。
結果が実行されない数 ResultNotExecutedCount Int32 テストの実行またはテストの結果に対して Not Executed として報告される毎日のテスト結果の数。
結果の警告の数 ResultWarningCount Int32 テストの実行またはテスト結果の Warning として報告される毎日のテスト結果の数。
結果が適用されない数 ResultNotApplicableCount Int32 テストの実行またはテスト結果の 該当なし として報告される毎日のテスト結果の数。
影響を受けなかった結果の数 ResultNotImpactedCount Int32 テストの実行またはテストの結果について、毎日 影響を受けない として報告されたテスト結果の数。
実行時間 (秒) RunDurationSeconds 10 進法 テスト構成の状態 (アクティブまたは非アクティブ)。
開始日 StartedDate DateTime テスト実行の開始日時。
テスト実行 ID TestRunId Int32 テストの実行に割り当てられた数。
テスト実行の種類 TestRunType Enumerated 手動または自動のテストの種類かどうかを示します。 有効な値は、 TestRunType の下に表示されます。
Title Title String パイプライン タスクに割り当てられた GUID。
Workflow Workflow Enumerated パイプライン ワークフローの種類。 有効な値は、 SourceWorkflow の下に一覧表示されます。

次の表に、 TestRun エンティティ型に対して有効なナビゲーション プロパティを示します。

名前 参照制約 Referenced プロパティ
Branch BranchSK BranchSK
CompletedOn CompletedDateSK DateSK
Pipeline PipelineSK PipelineSK
PipelineRun PipelineRunSK PipelineRunSK
Project ProjectSK ProjectSK
StartedOn StartedDateSK DateSK

TestSuites

テスト スイートはテスト 計画用に定義され、実行するテストを指定します。 詳細についてはテスト計画およびテスト スイートの作成 を参照してください。

次のプロパティは、 TestSuites とそのサロゲート キー TestSuiteSKに対して有効です。

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
テスト 計画 ID TestPlanId Int32 テスト ケースに割り当てられた番号 (ID ではありません)。
Test Suite Id TestSuiteId Int32 テスト構成に割り当てられた名前。
テスト 計画のタイトル TestPlanTitle String テスト計画のタイトル。
Test Suite のタイトル Title Int32 テスト ケースに割り当てられた番号 (ID ではありません)。
OrderId OrderId Int32 テスト構成に割り当てられた名前。
Test Suite Level 1 Id から Test Suite Level 14 ID IdLevel1 通じてIdLevel14 Int32 入れ子になったテスト スイートのレベル。
Test Suite Level 1 Title through Test Suite Level 14 Title TitleLevel1 から TitleLevel14 String 入れ子になったテスト スイート レベルの名前。
Test Suite Depth Depth Byte テスト 計画内のテスト スイートの入れ子になったレベル。
テスト スイートの種類 Type Enumerated テスト スイートの種類を指定します。 TestSuiteType 列挙型の有効な値が一覧表示されます。
テスト 計画 ID TestPlanId Int32 テスト 計画に割り当てられた番号 (ID ではありません)。
要件作業項目 ID RequirementWorkItemId Int32 テスト スイートに関連付けられている作業項目のユーザー ストーリー、製品バックログ項目、またはその他の要件カテゴリの作業項目の ID。
テスト 計画のタイトル TestPlanTitle String テスト計画に対して定義されたタイトル。

次の表に、 TestSuite エンティティ型に対して有効なナビゲーション プロパティを示します。

表示名 名前 参照制約 Referenced プロパティ
Project Project ProjectSK ProjectSK
要件作業項目 RequirementWorkItem RequirementWorkItemId WorkItemId
テスト計画作業項目 TestPlanWorkItem TestPlanId WorkItemId
Test Suite の作業項目 TestSuiteWorkItem TestSuiteId WorkItemId

TestSuiteType 列挙型メンバー

次のメンバーは、 TestSuiteType 列挙型に対して定義されます。

メンバー名 表示名
None 0 なし
QueryBased 1 クエリ ベース
Static 2 静的
RequirementBased 3 要件ベース