共用方式為


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 查詢。

實體集和實體類型

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

注意

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 測試套件資訊。 如需定義測試套件的詳細資訊,請參閱 建立測試計劃和測試套件

Tests

下列屬性適用於 測試 實體類型和 測試 實體集。 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 的有效值如下所示
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 針對列舉型別摘要的六種狀態之一。

成員名稱 Display name
None 0
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 Timeout 測試執行持續時間超過指定的臨界值。
Aborted 6 已中止 測試執行因內部或外部因素而突然終止,例如,不正確的程式代碼、環境問題。
Blocked 7 封鎖
NotExecuted 8 未執行 標記為略過執行的測試。
Warning 9 警告
Error 10 錯誤
NotApplicable 11 不適用
Paused 12 已暫停
InProgress 13 進行中
NotImpacted 14 未受影響 測試不會受到觸發管線的程式代碼變更所影響。

TestPointHistorySnapshot

下列屬性適用於 TestPointHistorySnapshot 實體集。 Surrogate 索引鍵包括 TestPointSKDateSK

顯示名稱 名稱 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
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

TestResults

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

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

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

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

Display name 成員名稱
建立 Build 1
版本 Release 2
手動 Manual 3

TestRunType 列舉類型成員

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

成員名稱 Display name
Automated 1 自動化
Manual 2 手動

TestResultsDaily

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

顯示名稱 名稱 Data type 說明
AnalyticsUpdatedDate Datetime 浮浮水印,指出上次更新分析數據的時間。
發行管線標識碼 ReleasePipelineId Int32 指派給相關聯發行管線的數位。
發行階段標識碼 ReleaseStageId Int32 指派給相關聯發行管線階段的數位。
結果中止計數 ResultAbortedCount Int32 報告為 每日測試結果中止 的測試結果數目。
結果封鎖計數 ResultBlockedCount Int32 每日針對測試結果回報為 [封鎖 ] 的測試結果數目。
結果計數 ResultCount Int32 報告的測試結果總數。
結果持續時間秒 ResultDurationSeconds Decimal 執行所需測試結果的秒數。
結果錯誤計數 ResultErrorCount Int32 每天回報為 測試結果錯誤 的測試結果數目。
結果失敗計數 ResultFailCount Int32 報告為 每日測試結果失敗 的測試結果數目。
結果 Flaky 計數 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 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 布林值 指出是否提供測試回合的詳細數據 (True) 或否 (False)。
為自動化 IsAutomated 布林值 指出是否提供測試回合的詳細數據 (True) 或否 (False)。
優先順序 Priority Int32 指派給管線工作的版本。
完成日期 CompletedDate Datetime 測試回合或測試結果完成的日期時間。
版本標識碼 ReleaseId Int32 指派給相關聯發行定義的號碼。
發行環境標識碼 ReleaseEnvironmentId Int32 指派給相關聯發行環境的數位。
發行管線標識碼 ReleasePipelineId Int32 指派給相關聯發行管線的數位。
發行階段標識碼 ReleaseStageId Int32 指派給相關聯發行管線階段的數位。
結果中止計數 ResultAbortedCount Int32 報告為 測試回合或測試結果每日中止 的測試結果數目。
結果封鎖計數 ResultBlockedCount Int32 每天針對測試回合或測試結果回報為 [封鎖 ] 的測試結果數目。
結果計數 ResultCount Int32 報告的測試結果總數。
結果持續時間秒 ResultDurationSeconds Decimal 測試執行所需的秒數。
結果錯誤計數 ResultErrorCount Int32 每天針對測試回合或測試結果回報為 Error 的測試結果數目。
結果失敗計數 ResultFailCount Int32 報告為 每日測試回合或測試結果失敗 的測試結果數目。
結果 Flaky 計數 ResultFlakyCount Int32 標示為浮點的測試結果數目。 浮點測試是間歇性失敗的測試,因為沒有明顯的原因,例如變更程式碼或測試。 如需詳細資訊,請參閱 管理浮點測試
結果不定計數 ResultInconclusiveCount String 每天針對測試回合或測試結果回報為 不確定 的測試結果數目。
結果傳遞計數 ResultPassCount Int32 每天針對測試回合或測試結果回報為 「通過 」的測試結果數目。
結果逾時計數 ResultTimeoutCount Int32 報告為測試回合或測試結果每日逾時的測試結果數目。
結果未執行計數 ResultNotExecutedCount Int32 每天針對測試回合或測試結果回報為 「未執行 」的測試結果數目。
結果警告計數 ResultWarningCount Int32 每天針對測試回合或測試結果回報為 警告 的測試結果數目。
結果不適用計數 ResultNotApplicableCount Int32 每天針對測試回合或測試結果回報為 不適用 的測試結果數目。
結果不受影響計數 ResultNotImpactedCount Int32 每天針對測試回合或測試結果回報為 「不受影響 」的測試結果數目。
執行持續時間秒 RunDurationSeconds Decimal 測試組態的狀態,可以是 [使用中] 或 [非使用中]。
開始日期 StartedDate Datetime 測試回合開始的日期時間。
測試回合識別碼 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 指派給測試案例的數位(而非標識符)。
Test Suite 識別符 TestSuiteId Int32 指派給測試組態的名稱。
測試計劃標題 TestPlanTitle String 測試計劃的標題。
測試套件標題 Title Int32 指派給測試案例的數位(而非標識符)。
OrderId OrderId Int32 指派給測試組態的名稱。
透過測試套件層級 14 標識碼的測試套件層級 14 標識符 IdLevel1 通過IdLevel14 Int32 巢狀測試套件的層級。
測試套件層級 1 標題測試套件層級 14 標題 TitleLevel1TitleLevel14 String 巢狀測試套件層級的名稱。
Test Suite Depth Depth Byte 測試計劃內測試套件的巢狀層級。
測試套件類型 Type Enumerated 指定測試套件的類型。 TestSuiteType 列舉型別會列出有效值。
測試計劃標識碼 TestPlanId Int32 指派給測試計劃的數位(而非標識符)。
需求工作項目標識碼 RequirementWorkItemId Int32 與測試套件相關聯的工作項目使用者故事、產品待辦專案或其他需求類別工作專案的標識符。
測試計劃標題 TestPlanTitle String 針對測試計劃定義的標題。

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

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

TestSuiteType 列舉型別成員

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

成員名稱 Display name
None 0
QueryBased 1 以查詢為基礎的
Static 2 靜態
RequirementBased 3 需求型