次の方法で共有


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 の作業追跡メタデータ リファレンスで説明されている作業追跡エンティティを使用して、このデータに関するレポートのクエリと生成を行うことができます。

EntitySet EntityType 説明
テスト テスト テスト名やテスト所有者など、テスト ケースのプロパティ。 テスト ケースの定義の詳細については、「手動テスト ケースの作成」を参照してください
TestConfigurations TestConfiguration テスト 計画の構成情報。 テストの構成の詳細については、「テストのさまざまな構成」を参照してください
TestPoints TestPoint テスト ポイントの実行情報。 テスト ポイントは、テスト ケース、テスト スイート、構成、テスターの一意の組み合わせです。 サンプル レポートについては、「進行状況の状態のサンプル レポート」を参照してください
TestPointHistorySnapshot TestPointHistorySnapshot (複合)TestRun に関連付けられている特定のテストの個々の実行結果。 サンプル レポートについては、「手動テスト実行の傾向サンプル レポート」を参照してください
TestResults TestResult TestRun に関連付けられている特定のテストの個々の実行結果。
TestResultsDaily TestResultDaily TestRun ではなく Test でグループ化された TestResult 実行の毎日のスナップショット集計。 サンプル レポートについては、「テストの概要傾向のサンプル レポート」を参照してください
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 エンティティ セットに対して有効です。 サロゲート キーには、次のものがDateSK含まれますTestPointSK

[表示名] 名前 データの種類 説明
AnalyticsUpdatedDate DateTime 分析データが最後に更新された時刻を示す透かし。
AssignedToUserSK GUID テスト作業項目に割り当てられた GUID。
IsLastDayOfPeriod Enumerated データをフィルター処理して、日、週、月、年などの異なる期間で 1 日が終了するかどうかを判断するために使用します。 有効な値は、ピリオド列挙型メンバーの一覧に示されています。
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 示します。

[表示名] メンバー名 Value
ビルド 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 10 進法 テスト結果の実行に必要な秒数。
結果エラー数 ResultErrorCount Int32 毎日のテスト結果のエラーとして報告されたテスト結果の数。
結果の失敗数 ResultFailCount Int32 毎日のテスト結果に対して失敗として 報告された テスト結果の数。
結果の不安定な数 ResultFlakyCount Int32 不安定な結果の数。 不安定なテストは、コードやテストの変更など、明らかな理由なしで断続的に失敗するテストです。 詳細については、「不安定なテストの管理」を参照してください
結果の不確定数 ResultInconclusiveCount Int32 毎日のテスト結果に対して不確定として報告されたテスト結果の数。
結果のパス数 ResultPassCount Int32 毎日のテスト結果に対して合格として 報告された テスト結果の数。
結果なしカウント ResultNoneCount Int32 毎日のテスト結果に対して None として報告されたテスト結果の数。
結果のタイムアウト数 ResultTimeoutCount Int32 テスト結果のタイムアウトとして報告される 1 日あたりのテスト結果の数。
結果が実行されない数 ResultNotExecutedCount Int32 毎日のテスト結果に対して未実行として 報告された テスト結果の数。
結果の警告の数 ResultWarningCount Int32 毎日のテスト結果の警告として報告されたテスト結果の数。
結果が適用されない数 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 テストの実行またはテストの結果を毎日中止として 報告された テスト結果の数。
結果ブロック数 ResultBlockedCount Int32 テストの実行またはテスト結果に対して 1 日あたりのブロックとして報告されるテスト結果の数。
結果の数 ResultCount Int32 報告されたテスト結果の合計数。
結果の継続時間 (秒) ResultDurationSeconds 10 進法 テストの実行に必要な秒数。
結果エラー数 ResultErrorCount Int32 毎日のテストの実行またはテスト結果のエラーとして報告されたテスト結果の数。
結果の失敗数 ResultFailCount Int32 毎日のテストの実行またはテスト結果に対して失敗として 報告された テスト結果の数。
結果の不安定な数 ResultFlakyCount Int32 不安定としてマークされたテスト結果の数。 不安定なテストとは、コードやテストの変更など、明らかな理由なしで断続的に失敗するテストです。 詳細については、「不安定なテストの管理」を参照してください
結果の不確定数 ResultInconclusiveCount String 毎日のテストの実行またはテスト結果に対して不確定として報告されたテスト結果の数。
結果のパス数 ResultPassCount Int32 テストの実行またはテスト結果に対して成功として 報告された 毎日のテスト結果の数。
結果のタイムアウト数 ResultTimeoutCount Int32 テストの実行またはテスト結果のタイムアウトとして報告される毎日のテスト結果の数。
結果が実行されない数 ResultNotExecutedCount Int32 毎日のテストの実行またはテスト結果に対して未実行として 報告された テスト結果の数。
結果の警告の数 ResultWarningCount Int32 テストの実行またはテスト結果の警告として報告された毎日のテスト結果の数。
結果が適用されない数 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 レベル 1 ID から Test Suite レベル 14 ID IdLevel1 通じてIdLevel14 Int32 入れ子になったテスト スイートのレベル。
Test Suite Level 1 タイトル から Test Suite Level 14 タイトル 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 要件ベース