次の方法で共有

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 テスト アクティビティでサポートされるエンティティ、プロパティ、列挙型について説明します。

注意

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

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

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

注意

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

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

テスト

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

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

表示名 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
コンテナー名 ContainerName String パイプライン内のテスト タスクを含むジョブ コンテナーの名前。
完全修飾テスト名 FullyQualifiedTestName String テスト用に作成された名前。 完全修飾名の形式は に Namespace.Testclass.Methodname 対応し、文字制限は 512 です。 テストがデータ ドリブンであり、パラメーターがある場合、文字制限にはパラメーターが含まれます。
優先順位 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。
自動化の状態 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 エンティティ セットのナビゲーション プロパティ を 示します。

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

TestResultState 列挙型メンバー

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

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

TestOutcome 列挙型メンバー

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

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

TestPointHistorySnapshot

次のプロパティは、 TestPointHistorySnapshot エンティティ セットに対して有効です。 サロゲート キーには、 と がDateSK含まれますTestPointSK。

表示名 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
AssignedToUserSK GUID テスト作業項目に割り当てられた GUID。
IsLastDayOfPeriod Enumerated データをフィルター処理して、日、週、月、年などの異なる期間で 1 日が終了するかどうかを判断するには、 を使用します。 有効な値は、 ピリオド列挙型のメンバーの一覧に記載されています。
TesterUserSK GUID テスト ポイントに関連付けられているテスト担当者に割り当てられた GUID。
TestConfigurationSK Int32 関連付けられているテスト構成に割り当てられたキー。
自動化の状態 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 エンティティ セット の ナビゲーション プロパティを示します。

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

TestResults

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

テストの実行は、「 .NET Core アプリのビルド、テスト、デプロイ」、「テストの実行」の説明に従って、テストを手動で実行するか、パイプライン定義内にテスト タスクを含めると発生します。

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

表示名 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
完了日 CompletedDate DateTime テスト結果の実行が完了した日時。
期間 (秒) DurationSeconds Decimal (10 進数型) テストの実行にかかった秒数。
はっくり IsFlaky ブール型 テストが不安定 (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 エンティティ型に有効なナビゲーション プロパティを示します。

名前 参照制約 参照先プロパティ
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 毎日のテスト結果に対して中止として報告 された テスト結果の数。
ブロックされた結果の数 ResultBlockedCount Int32 毎日のテスト結果に対して [ブロック] として報告されたテスト結果の数。
結果の数 ResultCount Int32 報告されたテスト結果の合計数。
結果の継続時間 (秒) ResultDurationSeconds Decimal テスト結果の実行に必要な秒数。
結果エラー数 ResultErrorCount Int32 毎日テスト結果の エラー として報告されるテスト結果の数。
結果の失敗数 ResultFailCount Int32 毎日のテスト結果に対して失敗として報告 された テスト結果の数。
結果の薄い数 ResultFlakyCount Int32 薄い結果の数。 薄いテストは、コードやテストの変更など、明らかな理由なしで断続的に失敗するテストです。 詳細については、「 薄いテストを管理する」を参照してください。
結果の不確定カウント ResultInconclusiveCount Int32 毎日のテスト結果に対して [不確定] として報告されたテスト結果の数。
結果のパス数 ResultPassCount Int32 毎日のテスト結果に 対して成功 として報告されたテスト結果の数。
結果なしカウント ResultNoneCount Int32 毎日のテスト結果に対して None として報告されたテスト結果の数。
結果のタイムアウト数 ResultTimeoutCount Int32 毎日テスト結果の タイムアウト として報告されるテスト結果の数。
結果が実行されない数 ResultNotExecutedCount Int32 毎日テスト結果に対して [未実行] として報告されたテスト結果の数。
結果の警告数 ResultWarningCount Int32 毎日テスト結果の 警告 として報告されたテスト結果の数。
結果が適用されないカウント ResultNotApplicableCount Int32 毎日テスト結果に 適用できない と報告されたテスト結果の数。
影響を受けなかった結果数 ResultNotImpactedCount Int32 毎日のテスト結果に対して [影響なし] として報告されたテスト結果の数。
結果の期間 (秒) ResultDurationSeconds Decimal テスト結果が完了するまでにかかった秒数。
開始日 StartedDate String テスト結果の開始日時。
テスト実行の種類 TestRunType Enumerated 手動または自動のテストの種類かどうかを示します。 有効な値は、 TestRunType の下に一覧表示されます。
Workflow Workflow Enumerated パイプライン ワークフローの種類。 有効な値は、 SourceWorkflow の下に一覧表示されます。

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

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

TestRuns

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

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

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

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

名前 参照制約 参照先プロパティ
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 テスト構成の状態 (アクティブまたは非アクティブ)。
テスト スイートのタイトル Title Int32 テスト ケースに割り当てられた番号 (ID ではありません)。
Orderid OrderId Int32 テスト構成に割り当てられた名前。
Test Suite レベル 1 ID から Test Suite レベル 14 ID IdLevel1 を通じてIdLevel14 Int32 入れ子になったテスト スイートのレベル。
Test Suite Level 1 Title through Test Suite Level 14 Title TitleLevel1 から TitleLevel14 String 入れ子になったテスト スイート レベルの名前。
テスト スイートの深さ Depth Byte テスト 計画内のテスト スイートの入れ子になったレベル。
テスト スイートの種類 Type Enumerated テスト スイートの種類を指定します。 TestSuiteType 列挙型の有効な値が一覧表示されます。
テスト プラン ID TestPlanId Int32 テスト 計画に割り当てられた番号 (ID ではありません)。
要件作業項目 ID RequirementWorkItemId Int32 テスト スイートに関連付けられている作業項目のユーザー ストーリー、製品バックログ アイテム、またはその他の要件カテゴリの作業項目の ID。
テスト 計画のタイトル TestPlanTitle String テスト計画に定義されているタイトル。

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

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

TestSuiteType 列挙型メンバー

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

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