分享方式：

Test Plans Analytics 的中繼資料參考

  • 文章

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

分析服務會收集所有 Azure DevOps 測試活動的所有資料。 Azure Test Plans支援規劃和探勘測試的定義和執行。 使用 Azure Pipelines，您也可以使用持續整合/持續部署 (CI/CD) 工作流程來執行自動化測試。

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

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

注意

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

實體集和實體類型

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

注意

v3.0-preview和v4.0-preview版本支援 Azure DevOps 測試的分析。
分析會將所有測試相關工作專案儲存為工作專案。 您可以使用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 測試套件資訊。 如需定義測試套件的詳細資訊，請參閱 建立測試計劃和測試套件。

測試

下列屬性適用于 測試 實體類型和 測試 實體集。 Surrogate 索引鍵為 TestSK 。

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

顯示名稱 名稱 Data type 說明
AnalyticsUpdatedDate Datetime 浮水印，指出上次更新分析資料的時間。
容器名稱 ContainerName String 包含管線內測試工作的作業容器名稱。
完整測試名稱 FullyQualifiedTestName String 為測試建立的名稱。 完整名稱格式會對應至 Namespace.Testclass.Methodname 字元限制為 512。 如果測試是資料驅動且具有參數，字元限制將會包含參數。
優先順序 Priority Int32 指定測試的重要性或重要性程度。 優先順序通常會指定為測試程式碼中的屬性。
測試案例參考識別碼 TestCaseReferenceId Int32 數位 (不是指派給測試案例) 識別碼。
測試名稱 TestName String 測試的名稱。
測試擁有者 TestOwner String 測試或測試回合的擁有者。 測試擁有者通常會在測試程式碼中指定為屬性。 如需支援的測試結果格式，請參閱 發佈測試結果工作 ，以檢視擁有者屬性的對應。

TestConfigurations

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

下列屬性適用于TestConfiguration 實體類型和 TestConfigurations實體集及其 Surrogate 索引鍵 。TestConfigurationSK

顯示名稱 名稱 Data type 說明
測試組態識別碼 TestConfigurationId Int32 數位 (不是指派給測試案例) 識別碼。
測試組態名稱 Name String 指派給測試組態的名稱。
測試組態狀態 State String 測試組態的狀態，可以是 [作用中] 或 [非作用中]。

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

TestPoints

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

顯示名稱 名稱 Data type 說明
AssignedToUserSK GUID 指派給與測試點相關聯的測試人員 GUID。
TesterUserSK GUID 指派給與測試點相關聯的測試人員 GUID。
自動化狀態 AutomationStatus Enumerated 測試案例的狀態，例如自動化、非自動化或計畫。 對應至 Microsoft.VSTS.TCM.AutomationStatus 工作專案欄位。
變更日期 ChangedDate Datetime 上次變更測試點的日期時間。
上次結果狀態 LastResultState Enumerated 測試點的狀態，例如擱置、佇列或進行中。 TestResultState的有效值如下。
優先順序 Priority Int32 指派給相關聯測試案例的優先順序。
測試案例識別碼 TestCaseId Int32 指派給相關聯測試案例的工作專案識別碼。
測試組態識別碼 TestConfigurationId Int32 指派給相關聯測試組態的數位。
測試計劃識別碼 TestPlanId Int32 指派給相關聯測試計劃的工作專案識別碼。
測試結果結果 LastResultOutcome Enumerated 指定最後一個測試結果結果。 TestOutcome的有效值如下所列。
測試套件識別碼 TestSuiteId Int32 指派給相關聯測試套件的工作專案識別碼。

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

下表列出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 中列舉型別摘要的六種狀態之一。

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

TestOutcome 列舉型別成員

下表列出測試的 15 個結果，而且是列舉型別的成員 TestOutcome 。

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

TestPointHistorySnapshot

下列屬性適用于 TestPointHistorySnapshot 實體集。 Surrogate 索引鍵包括 TestPointSK 和 DateSK 。

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

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

顯示名稱 名稱 引用條件約束 Referenced 屬性
Date DateSK DateSK
指派對象 AssignedTo AssignedToUserSK UserSK
Project Project ProjectSK ProjectSK
測試案例工作專案 TestCase TestCaseId WorkItemId
測試組態 TestConfiguration TestConfigurationSK TestConfigurationSK
測試套件 TestSuite TestSuiteSK TestSuiteSK
測試人員使用者名稱 Tester TesterUserSK UserSK

TestResults

測試結果會對應至具有特定結果和詳細資料之測試案例執行的單一實例。

當您手動執行測試或包含管線定義中的測試工作時，就會執行測試回合，如建置 、測試及部署 .NET Core 應用程式中所述，執行測試。

下列屬性適用于 TestResults 實體集。 Surrogate 索引鍵為 TestResultSK 。

顯示名稱 名稱 Data type 說明
AnalyticsUpdatedDate Datetime 浮水印，指出上次更新分析資料的時間。
完成日期 CompletedDate Datetime 測試結果完成執行的日期時間。
工期秒數 DurationSeconds Decimal 測試執行所花費的秒數。
這是 Flaky IsFlaky Boolean 指出測試是否標示為 flaky (True) 或未 (False) 。 Flaky 測試是間歇性失敗的測試，因為沒有明顯的原因，例如程式碼或測試的變更。*** 如需詳細資訊，請參閱 管理 Flaky 測試。
版本識別碼 ReleaseId Int32 指派給與測試結果相關聯之發行的數位。
發行環境識別碼 ReleaseEnvironmentId Int32 指派給與測試結果相關聯之發行環境的號碼。
發行管線識別碼 ReleasePipelineId Int32 指派給與測試結果相關聯之發行管線的數位。
發行階段識別碼 ReleaseStageId Int32 指派給與測試結果相關聯之發行階段的數位。
開始日期 StartedDate Datetime 測試結果開始執行的日期時間。
測試結果識別碼 TestResultId Int32 指派給測試結果的數位。
測試回合 ID TestRunId Int32 指派給測試回合的數位。
測試回合類型 TestRunType Enumerated 指出其是否為手動或自動化測試類型。 TestRunType的有效值如下所列。
測試結果 Outcome Enumerated 測試回合結果。 測試結果有 15 個可能的結果：已中止、已封鎖、錯誤、失敗、不確定、進行中、無、不適用、未執行、未受影響、已傳遞、暫停、逾時、未指定和警告。 TestOutcome的有效值如下所列。
工作流程 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 Build 1
版本 Release 2
手動 Manual 3

TestRunType 列舉類型成員

下表列出為 SourceWorkflow 列舉型別定義的成員。

成員名稱 值 顯示名稱
Automated 1 自動化
Manual 2 手動

TestResultsDaily

下列屬性適用于 TestResultsDaily 實體集。 Surrogate 索引鍵為 TestResultsDailySK 。

顯示名稱 名稱 Data type 說明
AnalyticsUpdatedDate Datetime 浮水印，指出上次更新分析資料的時間。
發行管線識別碼 ReleasePipelineId Int32 指派給相關聯發行管線的數位。
發行階段識別碼 ReleaseStageId Int32 指派給相關聯發行管線階段的數位。
結果中止計數 ResultAbortedCount Int32 每日 針對測試結果回報為 Aborted 的測試結果數目。
結果封鎖計數 ResultBlockedCount Int32 每日針對測試結果回報為 已封鎖 的測試結果數目。
結果計數 ResultCount Int32 報告的測試結果總數。
結果持續時間秒數 ResultDurationSeconds Decimal 執行測試結果所需的秒數。
結果錯誤計數 ResultErrorCount Int32 每天針對測試結果回報為 Error 的測試結果數目。
結果失敗計數 ResultFailCount Int32 回報為每日測試結果 失敗 的測試結果數目。
結果 Flaky 計數 ResultFlakyCount Int32 Flaky 結果的數目。 Flaky 測試是間歇性失敗的測試，因為沒有明顯的原因，例如程式碼或測試的變更。 如需詳細資訊，請參閱 管理 Flaky 測試。
結果不一致計數 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 Enumerated 管線工作流程類型。 有效值列在 SourceWorkflow底下。

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

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

TestRuns

當您手動執行測試或包含管線定義中的測試工作時，就會執行測試回合。 若要深入瞭解，請參閱 建置、測試及部署 .NET Core 應用程式、執行測試。

下列屬性適用于 TestRuns 及其 Surrogate 索引鍵 TestRunSK 。

顯示名稱 名稱 Data type 說明
AnalyticsUpdatedDate Datetime 浮水印，指出上次更新分析資料的時間。
具有詳細資料 HasDetail Boolean 指出是否提供測試回合的詳細資料， (True) 或未 (False) 。
是自動化的 IsAutomated Boolean 指出是否提供測試回合的詳細資料， (True) 或未 (False) 。
優先順序 Priority Int32 指派給管線工作的版本。
完成日期 CompletedDate Datetime 測試回合或測試結果完成的日期時間。
版本識別碼 ReleaseId Int32 指派給相關聯發行定義的號碼。
發行環境識別碼 ReleaseEnvironmentId Int32 指派給相關聯發行環境的數位。
發行管線識別碼 ReleasePipelineId Int32 指派給相關聯發行管線的數位。
發行階段識別碼 ReleaseStageId Int32 指派給相關聯發行管線階段的數位。
結果中止計數 ResultAbortedCount Int32 每天針對測試回合或測試結果回報為 Aborted 的測試結果數目。
結果封鎖計數 ResultBlockedCount Int32 每天針對測試回合或測試結果回報為 [封鎖 ] 的測試結果數目。
結果計數 ResultCount Int32 報告的測試結果總數。
結果持續時間秒 ResultDurationSeconds Decimal 測試執行所需的秒數。
結果錯誤計數 ResultErrorCount Int32 每天針對測試回合或測試結果回報為 「錯誤 」的測試結果數目。
結果失敗計數 ResultFailCount Int32 每天針對測試回合或測試結果回報為 [失敗 ] 的測試結果數目。
結果 Flaky 計數 ResultFlakyCount Int32 標示為 flaky 的測試結果數目。 Flaky 測試是間歇性失敗的測試，沒有明顯的原因，例如程式碼或測試的變更。 如需詳細資訊，請參閱 管理 Flaky 測試。
結果不一致計數 ResultInconclusiveCount String 每天針對測試回合或測試結果回報為 Inconclusive 的測試結果數目。
結果傳遞計數 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 Enumerated 管線工作流程類型。 有效值列在 SourceWorkflow底下。

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

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

TestSuites

測試套件是針對測試計劃所定義，並指定要執行的測試。 若要深入瞭解，請參閱 建立測試計劃和測試套件。

下列屬性適用于 TestSuites 及其 Surrogate 索引鍵 TestSuiteSK 。

顯示名稱 名稱 Data type 說明
AnalyticsUpdatedDate Datetime 浮水印，指出上次更新分析資料的時間。
測試計劃識別碼 TestPlanId Int32 數位 (不是指派給測試案例的識別碼) 。
測試套件識別碼 TestSuiteId Int32 指派給測試組態的名稱。
測試計劃標題 TestPlanTitle String 測試組態的狀態，可以是 [作用中] 或 [非作用中]。
Test Suite 標題 Title Int32 數位 (不是指派給測試案例的識別碼) 。
OrderId OrderId Int32 指派給測試組態的名稱。
測試套件層級 1 識別碼 到 測試套件層級 14 識別碼 IdLevel1 通過IdLevel14 Int32 巢狀測試套件的層級。
測試套件層級 1 標題 至 測試套件層級 14 標題 TitleLevel1 通過 TitleLevel14 String 巢狀測試套件層級的名稱。
測試套件深度 Depth Byte 測試計劃內測試套件的巢狀層級。
測試套件類型 Type Enumerated 指定測試套件的類型。 TestSuiteType列舉型別會列出有效值。
測試計劃識別碼 TestPlanId Int32 數位 (不是指派給測試計劃的識別碼) 。
需求工作專案識別碼 RequirementWorkItemId Int32 與測試套件相關聯的工作專案使用者劇本、產品待辦專案或其他需求類別工作專案的識別碼。
測試計劃標題 TestPlanTitle String 為測試計劃定義的標題。

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

顯示名稱 名稱 引用條件約束 參考的屬性
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 需求型