共用方式為

Test Plans Analytics 的元數據參考

  • 發行項

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

分析服務會收集所有 Azure DevOps 測試活動的所有數據。 Azure 測試計劃支持規劃和探勘測試的定義和執行。 使用 Azure Pipelines，您也可以使用持續整合 /持續部署 （CI/CD） 工作流程執行自動化測試。

如果您不熟悉 Azure DevOps 測試，建議您檢視下列文章：

本文提供的元數據資訊說明所有 Azure DevOps 測試活動支援的實體、屬性和列舉類型。

注意

提供 Analytics 數據模型所支援的實體、屬性和列舉型別描述。 這是一個早期的草稿。 請提供您想要取得詳細資訊的區域意見反應。 若要查詢數據模型，請參閱 建構適用於分析的 OData 查詢。

實體集和實體類型

若要查詢測試計劃數據的分析，請使用下表所述的一或多個實體類型和實體集。

注意

Azure DevOps 測試的分析支援 v3.0-preview 和 v4.0-preview 版本。
分析會將所有測試相關的工作項目儲存為工作專案。 您可以使用Azure Boards Analytics 的工作追蹤元數據參考中所述的工作追蹤實體來查詢及生成此數據的報告。

EntitySet EntityType 描述
測試 Test 測試案例的屬性，例如測試名稱和測試擁有者。 如需定義測試案例的詳細資訊，請參閱 建立手動測試案例。
TestConfigurations TestConfiguration 測試計劃組態資訊。 如需設定測試的詳細資訊，請參閱 測試不同的組態。
TestPoints TestPoint 測試點的執行資訊。 測試點是測試案例、測試套件、設定和測試人員的唯一組合。 如需範例報表，請參閱 進度狀態範例報告。
TestPointHistorySnapshot TestPointHistorySnapshot （綜合）與 TestRun 相關聯的特定測試的個別執行結果。 如需範例報表，請參閱 手動測試執行趨勢範例報告。
TestResults TestResult 與 TestRun 相關聯的特定測試的個別執行結果。
TestResultsDaily TestResultDaily TestResult 執行的每日快照匯總，依 Test 分組（而非 TestRun）。 如需範例報表，請參閱 測試摘要趨勢範例報告。
TestRuns TestRun 在管線下執行之測試的匯總測試結果執行資訊。
TestSuites TestSuite 測試套件資訊。 如需定義測試套件的詳細資訊，請參閱 建立測試計劃和測試套件。

測試

下列屬性適用於 測試 實體類型和 測試 實體集。 代理鍵為 TestSK。

導覽屬性包括 Project 及其引用條件約束 ProjectSK。

顯示名稱 名稱 資料類型 說明
AnalyticsUpdatedDate 日期時間 浮浮水印，指出上次更新分析數據的時間。
容器名稱 ContainerName 字串 包含管線內測試工作的作業容器名稱。
完整測試名稱 FullyQualifiedTestName 字串 為測試建立的名稱。 完整名稱格式對應於 Namespace.Testclass.Methodname，其字元限制為 512。 如果測試是由數據驅動且具有參數，字元限制會包含參數。
優先順序 Priority Int32 指定測試的重要性或關鍵性程度。 優先順序通常會指定為測試程序代碼中的屬性。
測試案例參考標識碼 TestCaseReferenceId Int32 指派給測試案例的編號（而非標識符）。
測試名稱 TestName 字串 測試的名稱。
測試擁有者 TestOwner 字串 測試或測試回合的擁有者。 測試擁有者通常會在測試程式代碼中指定為屬性。 請參閱 發佈測試結果工作 ，以檢視所支持測試結果格式的擁有者屬性對應。

測試配置

測試組態會指定執行測試的不同環境，如測試不同的組態中所述。

下列屬性對 TestConfiguration 實體類型和 TestConfigurations 實體集以及其替代索引鍵 TestConfigurationSK 有效。

顯示名稱 名稱 資料類型 說明
測試組態標識碼 TestConfigurationId Int32 指派給測試案例的編號（而非ID）。
測試組態名稱 Name 字串 指派給測試組態的名稱。
測試組態狀態 State 字串 測試組態的狀態，可以是 [使用中] 或 [非使用中]。

導覽屬性包括 Project 及其引用條件約束 ProjectSK。

TestPoints

測試點是測試案例、測試套件、設定和測試人員的唯一組合。 下列屬性適用於 TestPoint EntityType 和 TestPoints EntitySet。 Surrogate 鍵值為 TestPointSK。

顯示名稱 名稱 資料類型 說明
AssignedToUserSK GUID 指派給與測試點相關聯測試人員的 GUID。
TesterUserSK 全域唯一識別碼 (GUID) 指派給與測試點相關的測試人員之 GUID。
自動化狀態 AutomationStatus 列舉 測試案例的狀態，例如[自動化]、[未自動化] 或 [已規劃]。 對應至 Microsoft.VSTS.TCM.AutomationStatus 工作專案欄位。
已變更日期 ChangedDate 日期時間 上次變更測試點的日期時間。
上次結果狀態 LastResultState 列舉 測試點的狀態，例如待處理、已排入佇列或進行中。 TestResultState 的有效值如下所示。
優先順序 Priority Int32 指派給相關聯測試案例的優先順序。
測試案例標識碼 TestCaseId Int32 指派給相關聯測試案例的工作項目標識碼。
測試組態標識碼 TestConfigurationId Int32 指派給相關聯測試組態的數位。
測試計劃標識碼 TestPlanId Int32 指派給相關聯測試計劃的工作項目標識碼。
測試結果結果 LastResultOutcome 列舉的 指定最後一個測試結果結果。 TestOutcome 的有效值如下所示。
Test Suite 識別符 TestSuiteId Int32 指派給相關聯測試套件的工作項目標識碼。

若要透過使用者介面檢閱測試點，請參閱 執行手動測試、儲存結果、關閉會話，以及檢閱結果。

下表列出 TestPoint 實體類型和 TestPoints 實體集的導覽屬性。

顯示名稱 名稱 引用條件約束 參考屬性
ChangedOn ChangedDateSK DateSK
指派至 AssignedTo AssignedToUserSK UserSK
專案 Project ProjectSK ProjectSK
測試用例工作項目 TestCase TestCaseId WorkItemId
測試組態 TestConfiguration TestConfigurationSK TestConfigurationSK
測試套件 TestSuite TestSuiteSK TestSuiteSK
測試人員用戶名稱 Tester TesterUserSK UserSK

TestResultState 列舉類型成員

測試結果可以是列舉型別所定義的六種狀態之一，這些狀態已在下表 TestResultState 中匯總。

成員名稱 價值 顯示名稱
None 0 無
Pending 1 待處理
Queued 2 佇列
InProgress 3 進行中
Paused 4 已暫停
Completed 5 已完成

TestOutcome 列舉類型成員

下表列出了測試的 15 個結果，並且這些結果被定義為 TestOutcome 列舉型別的成員。

成員名稱 值 顯示名稱 描述
Unspecified 0 未指定
None 1 無
Passed 2 通過 測試已成功執行。
Failed 3 失敗 測試結果不符合預期。
Inconclusive 4 結果不明 測試沒有明確的結果。
Timeout 5 Timeout 測試執行持續時間超過指定的臨界值。
Aborted 6 已中止 測試執行因內部或外部因素而突然終止，例如，不正確的程式代碼、環境問題。
Blocked 7 封鎖
NotExecuted 8 未執行 標記為略過執行的測試。
Warning 9 警告
Error 10 錯誤
NotApplicable 11 不適用
Paused 12 已暫停
InProgress 13 進行中
NotImpacted 14 未受影響 測試不會受到觸發管線的程式代碼變更所影響。

TestPointHistorySnapshot

下列屬性適用於 TestPointHistorySnapshot 實體集。 代理鍵包括 TestPointSK 和 DateSK。

顯示名稱 名稱 資料類型 說明
AnalyticsUpdatedDate 日期時間 浮浮水印，指出上次更新分析數據的時間。
AssignedToUserSK GUID 指派給測試工作專案的 GUID。
IsLastDayOfPeriod 列舉 用來篩選數據，以判斷某一天是否在不同的期間完成，例如天、周、月或年。 有效值列於此處： 期間列舉型別成員。
TesterUserSK GUID（全球唯一識別碼） 指派給與測試點相關聯測試人員的 GUID。
TestConfigurationSK Int32 指派給相關聯測試組態的金鑰。
自動化狀態 AutomationStatus 列舉型 測試案例的狀態，例如[自動化]、[未自動化] 或 [已規劃]。 對應至 Microsoft.VSTS.TCM.AutomationStatus 工作專案欄位。
優先順序 Priority Int32 分配給相關聯測試案例的優先順序。
測試案例標識碼 TestCaseId Int32 指派給相關聯測試案例的工作項目標識碼。
測試組態標識碼 TestConfigurationId Int32 指派給相關聯測試組態的數位。
測試計劃標識碼 TestPlanId Int32 指派給相關聯測試計劃的工作項目標識碼。
測試結果結果 ResultOutcome 列舉的 指定最後一個測試結果結果。 有效值會列在 TestOutcome 中。
Test Suite 識別符 TestSuiteId Int32 指派給相關聯測試套件的工作項目標識碼。

下表列出 TestPointHistorySnapshot 實體類型和 TestPointHistorySnapshot 實體集的導覽屬性。

顯示名稱 名稱 引用條件約束 參考屬性
Date DateSK DateSK
指派至 AssignedTo AssignedToUserSK UserSK
專案 Project ProjectSK ProjectSK
測試案例工作項目 TestCase TestCaseId WorkItemId
測試組態 TestConfiguration TestConfigurationSK TestConfigurationSK
測試套件 TestSuite TestSuiteSK TestSuiteSK
測試人員用戶名稱 Tester TesterUserSK UserSK

測試結果

測試結果對應於具有特定結果和詳細數據之測試案例執行的單一實例。

當您手動執行測試或在管線定義中包含測試任務時，就會進行測試運行。 如需詳細資訊，請參閱 建置、測試及部署 .NET Core 應用程式、執行測試。

下列屬性適用於 TestResults 實體集。 代理索引鍵為 TestResultSK。

顯示名稱 名稱 資料類型 說明
AnalyticsUpdatedDate 日期時間 浮浮水印，指出上次更新分析數據的時間。
完成日期 CompletedDate 日期時間 測試結果完成執行的日期時間。
持續時間秒 DurationSeconds Decimal 測試執行所花費的秒數。
不可靠 IsFlaky 布林值 指出測試是否標示為不穩定（True）或否（False）。 Flaky Test 是指沒有明顯原因而間歇性失敗的測試，例如因程式碼或測試的變更而導致。**** 如需詳細資訊，請參閱 管理 Flaky Test。
版本標識碼 ReleaseId Int32 與測試結果相關的發行版本指定的號碼。
發行環境識別碼 ReleaseEnvironmentId Int32 指派給與測試結果相關聯的發行環境的號碼。
發行管線標識碼 ReleasePipelineId Int32 指派給與測試結果相關聯的發行管線的編號。
發行階段標識碼 ReleaseStageId Int32 指派給與測試結果相關聯之發行階段的數字。
開始日期 StartedDate 日期時間 測試結果開始執行的日期時間。
測試結果標識碼 TestResultId Int32 指派給測試結果的數位。
測試回合識別碼 TestRunId Int32 指派給測試回合的號碼。
測試回合類型 TestRunType 列舉 指出它是手動或自動化測試類型。 TestRunType 的有效值如下所示。
測試結果 Outcome 列舉的 測試回合結果。 測試結果有 15 個可能的結果：中止、封鎖、錯誤、失敗、無決定性、進行中、無、不適用、未執行、未受影響、已通過、暫停、逾時、未指定及警告。 TestOutcome 的有效值如下所示。
工作流程 Workflow 列舉 管線工作流程類型。 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 實體集。 Surrogate 索引鍵為TestResultsDailySK 。

顯示名稱 名稱 資料類型 說明
AnalyticsUpdatedDate 日期時間 浮浮水印，指出上次更新分析數據的時間。
發行流水線標識碼 ReleasePipelineId Int32 指派給相關發行管線的編號。
發行階段識別碼 ReleaseStageId Int32 指派給相關發行管線階段的數字。
結果中止計數 ResultAbortedCount Int32 報告為中止的測試結果數目為每天。
結果封鎖次數 ResultBlockedCount Int32 每日針對測試結果回報為 [封鎖 ] 的測試結果數目。
結果計數 ResultCount Int32 報告的測試結果總數。
結果持續時間秒 ResultDurationSeconds 十進制 執行所需測試結果的秒數。
結果錯誤計數 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 字串 測試結果的開始日期和時間。
測試回合類型 TestRunType 列舉 指出它是手動或自動化測試類型。 有效值列在 TestRunType 底下。
工作流程 Workflow 列舉 管線工作流程類型。 有效值列在SourceWorkflow底下。

下表列出適用於 TestResultDaily 實體類型的導覽屬性。

名稱 引用條件約束 參考屬性
Branch BranchSK BranchSK
Date StartedDateSK DateSK
Pipeline PipelineSK PipelineSK
Project ProjectSK ProjectSK
Test TestSK TestSK

TestRuns

當您手動執行測試或在管道定義中包含測試工作時，就會執行測試運行。 如需詳細資訊，請參閱 建置、測試及部署 .NET Core 應用程式、執行測試。

下列屬性對 TestRuns 及其 Surrogate 索引鍵 TestRunSK有效。

顯示名稱 名稱 資料類型 說明
AnalyticsUpdatedDate 日期時間 浮浮水印，指出上次更新分析數據的時間。
具有詳細數據 HasDetail 布林值 表示是否提供測試運行的詳細資料 (是) 或否 (否)。
是自動化的 IsAutomated 布林值 指出是否提供測試回合的詳細數據 （True） 或否 （False）。
優先順序 Priority Int32 指派給管線工作的版本。
完成日期 CompletedDate 日期時間 測試回合或測試結果完成的日期時間。
版本標識碼 ReleaseId Int32 關聯版本定義所指派的號碼。
發行環境ID ReleaseEnvironmentId Int32 指派給相關聯發行環境的編號。
發行管線標識碼 ReleasePipelineId Int32 指派給相關的發行管線的編號。
發佈階段識別碼 ReleaseStageId Int32 分配給相關的發行管線階段的數字。
中止結果計數 ResultAbortedCount Int32 報告中將測試回合或測試結果標記為每日中止的測試結果數目。
結果被阻擋次數 ResultBlockedCount Int32 每天回報的測試回合或測試結果中被標記為封鎖的測試結果數量。
結果計數 ResultCount Int32 報告的測試結果總數。
結果持續時間秒 ResultDurationSeconds Decimal 測試執行所需的秒數。
結果錯誤計數 ResultErrorCount Int32 每天記錄測試回合或測試結果中被回報為 Error 的測試結果數量。
結果失敗次數 ResultFailCount Int32 每日報告為失敗的測試執行或測試結果數目。
結果不穩定計數 ResultFlakyCount Int32 標示為不一致的測試結果數目。 不穩定測試是指那些因為沒有明顯理由而間歇性失敗的測試，例如程式碼或測試的變更。 如需詳細資訊，請參閱 管理浮點測試。
結果不確定計數 ResultInconclusiveCount 字串 每天針對測試回合或測試結果回報為 不確定 的測試結果數目。
結果通過計數 ResultPassCount Int32 每天回報為 「通過」 的測試回合或測試結果的數目。
結果超時計數 ResultTimeoutCount Int32 報告為超時的測試回合或測試結果的每日測試結果數量。
未執行結果計數 ResultNotExecutedCount Int32 每天針對測試回合或測試結果回報為 「未執行 」的測試結果數目。
結果警告計數 ResultWarningCount Int32 每天針對測試回合或測試結果回報為 警告 的測試結果數目。
結果不適用數量 ResultNotApplicableCount Int32 每天針對測試回合或測試結果回報為 不適用 的測試結果數目。
結果不受影響計數 ResultNotImpactedCount Int32 每天針對測試回合或測試結果回報為 「不受影響 」的測試結果數目。
執行持續時間秒 RunDurationSeconds Decimal 測試組態的狀態，可以是 [使用中] 或 [非使用中]。
開始日期 StartedDate 日期時間 測試回合開始的日期時間。
測試回合識別碼 TestRunId Int32 指派給測試回合的數位。
測試回合類型 TestRunType 列舉 指出它是手動或自動化測試類型。 有效值列在 TestRunType 底下。
標題 Title 字串 指派給管道任務的 GUID。
工作流程 Workflow 列舉 管線工作流程類型。 有效值列在SourceWorkflow底下。

下表列出對於 TestRun 實體類型有效的導覽屬性。

名稱 引用條件約束 參考屬性
Branch BranchSK BranchSK
CompletedOn CompletedDateSK DateSK
Pipeline PipelineSK PipelineSK
PipelineRun PipelineRunSK PipelineRunSK
Project ProjectSK ProjectSK
StartedOn StartedDateSK DateSK

測試套件

測試套件是針對測試計劃所定義，並指定要執行的測試。 如需詳細資訊，請參閱 建立測試計劃和測試套件。

下列屬性適用於 TestSuites 及其代理鍵 TestSuiteSK。

顯示名稱 名稱 資料類型 說明
AnalyticsUpdatedDate 日期時間 浮浮水印，指出上次更新分析數據的時間。
測試計劃標識碼 TestPlanId Int32 指派給測試案例的編號（而非標識符）。
Test Suite 識別符 TestSuiteId Int32 指派給測試組態的名稱。
測試計劃標題 TestPlanTitle 字串 測試計劃的標題。
測試套件標題 Title Int32 指派給測試案例的號碼（而非ID）。
OrderId OrderId Int32 指派給測試組態的名稱。
測試套件層級 1 標識碼到測試套件層級 14 標識碼 IdLevel1 透過IdLevel14 Int32 巢狀測試套件的層級。
測試套件層級 1 標題 至 測試套件層級 14 標題 TitleLevel1 至 TitleLevel14 字串 巢狀測試套件層級的名稱。
測試套件深度 Depth Byte 測試計劃內測試套件的巢狀層級。
測試套件類型 Type 枚舉 指定測試套件的類型。 TestSuiteType 列舉型別的有效值列出如下。
測試計劃標識碼 TestPlanId Int32 被分配給測試計劃的編號（而非識別碼）。
需求工作項目標識碼 RequirementWorkItemId Int32 與測試套件相關聯的工作項目，包括使用者故事、產品待辦項目或其他需求類別工作項目的識別碼。
測試計劃標題 TestPlanTitle 字串 針對測試計劃定義的標題。

下表列出對於 TestSuite 實體類型有效的導覽屬性。

顯示名稱 名稱 引用條件約束 參考屬性
專案 Project ProjectSK ProjectSK
需求工作專案 RequirementWorkItem RequirementWorkItemId WorkItemId
測試計劃工作項目 TestPlanWorkItem TestPlanId WorkItemId
測試套件工作專案 TestSuiteWorkItem TestSuiteId WorkItemId

TestSuiteType 列舉型別成員

下列成員是針對 TestSuiteType 列舉型別所定義。

成員名稱 價值 顯示名稱
None 0 無
QueryBased 1 以查詢為基礎的
Static 2 靜態
RequirementBased 3 基於需求