Test Point - Get Points

服务:

Test Plan

API 版本:

7.1

从套件获取特定的测试点。

GET https://dev.azure.com/{organization}/{project}/_apis/testplan/Plans/{planId}/Suites/{suiteId}/TestPoint?pointId={pointId}&api-version=7.1

具有可选参数:

GET https://dev.azure.com/{organization}/{project}/_apis/testplan/Plans/{planId}/Suites/{suiteId}/TestPoint?pointId={pointId}&returnIdentityRef={returnIdentityRef}&includePointDetails={includePointDetails}&api-version=7.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
planId	path	True	integer (int32)	请求测试点的测试计划的 ID。
project	path	True	string	项目 ID 或项目名称
suiteId	path	True	integer (int32)	为其请求测试点的测试套件的 ID。
api-version	query	True	string	要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。
pointId	query	True	string	要提取的测试点的 ID。
includePointDetails	query		boolean	如果设置为 false，将获取仅包含有关测试点对象的基本详细信息的较小有效负载
returnIdentityRef	query		boolean	如果设置为 true，则返回 TestCaseReference 中的 AssignedTo 字段作为 IdentityRef 对象。

响应

名称	类型	说明
200 OK	TestPoint[]	成功作

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

作用域

名称	说明
vso.test	授予读取测试计划、用例、结果和其他测试管理相关项目的能力。

定义

名称	说明
FailureType	测试点的失败类型
IdentityRef
LastResolutionState	测试点的最后一个解析状态 ID
LastResultDetails	测试点的最后一个结果详细信息。
Outcome	测试点的结果
PointState	测试点的状态
ProjectState	项目状态。
ProjectVisibility	项目可见性。
ReferenceLinks	表示 REST 引用链接集合的类。
ResultState	测试点的最后结果状态
TeamProjectReference	表示对 TeamProject 的浅表引用。
TestCaseReference	测试用例参考
TestConfigurationReference	测试配置参考
TestPlanReference	测试计划参考资源。
TestPoint	Test Point 类
TestPointResults	测试结果
TestSuiteReference	测试套件参考资源。

FailureType

枚举

测试点的失败类型

值	说明
known_Issue
maxValue
new_Issue
none
null_Value
regression
unknown

IdentityRef

Object

名称	类型	说明
_links	ReferenceLinks	此字段包含有关图形主题的零个或多个有趣的链接。 可以调用这些链接以获取有关此图形主题的其他关系或更详细的信息。
descriptor	string	描述符是在系统运行时引用图形主题的主要方法。 此字段将唯一标识帐户和组织中的同一图形主题。
directoryAlias	string	已弃用 - 可以通过查询 IdentityRef“_links”字典的“self”条目中引用的 Graph 用户来检索
displayName	string	这是图形主题的非唯一显示名称。 若要更改此字段，必须在源提供程序中更改其值。
id	string
imageUrl	string	已弃用 - 在 IdentityRef“_links”字典的“虚拟形象”条目中可用
inactive	boolean	已弃用 - 可以通过查询 GraphUser“_links”字典的“membershipState”条目中引用的 Graph 成员身份状态来检索
isAadIdentity	boolean	已弃用 - 可以从描述符的主题类型推断（Descriptor.IsAadUserType/Descriptor.IsAadGroupType）
isContainer	boolean	已弃用 - 可以从描述符的主题类型推断（描述符.IsGroupType）
isDeletedInOrigin	boolean
profileUrl	string	已弃用 - 不在 ToIdentityRef 的大多数预先存在的实现中使用
uniqueName	string	已弃用 - 请改用 Domain+PrincipalName
url	string	此 URL 是指向此图形主题的源资源的完整路由。

LastResolutionState

枚举

测试点的最后一个解析状态 ID

值	说明
configurationIssue
maxValue
needsInvestigation
none
nullValue
productIssue
testIssue

LastResultDetails

Object

测试点的最后一个结果详细信息。

名称	类型	说明
dateCompleted	string (date-time)	最后一个结果的已完成日期。
duration	integer (int64)	最后一个结果的持续时间（以毫秒为单位）。
runBy	IdentityRef	执行最后一个结果的用户。

Outcome

枚举

测试点的结果

值	说明
aborted	测试已中止。 这不是由用户手势造成的，而是由框架决策造成的。
blocked	测试有机会执行，但不是，因为 ITestElement.IsRunnable == false。
error	尝试执行测试时出现系统错误。
failed	测试已执行，但存在问题。 问题可能涉及异常或失败断言。
inProgress	测试当前正在执行。 为中医图表添加了此项
inconclusive	测试已完成，但我们无法说明它是否已通过或失败。 可用于中止的测试...
maxValue
none	测试尚未完成，或者测试类型不报告通过/失败。
notApplicable	测试不适用于执行。
notExecuted	未执行测试。 这是由用户手势引起的，例如用户点击停止按钮。
notImpacted	测试不受影响。 添加了 fot TIA。
passed	测试已执行，但出现任何问题。
paused	测试已暂停。
timeout	测试超时
unspecified	仅在更新期间使用以保留现有值。
warning	由运行级别结果使用。 这不是失败。

PointState

枚举

测试点的状态

值	说明
completed	测试已成功通过，无需重新运行测试，才能将测试通过视为完成。
inProgress	正在执行测试。
maxValue
none	违约
notReady	需要执行测试点，但无法执行。
ready	需要执行测试点才能将测试通过视为完成。 测试以前未运行，或者上一次运行失败。

ProjectState

枚举

项目状态。

值	说明
all	所有项目，无论状态如何，都已删除。
createPending	项目已排队创建，但该过程尚未启动。
deleted	项目已被删除。
deleting	项目正在删除。
new	正在创建项目。
unchanged	项目尚未更改。
wellFormed	项目已完全创建并可供使用。

ProjectVisibility

枚举

项目可见性。

值	说明
private	只有具有显式访问权限的用户才能看到该项目。
public	项目对所有人可见。

ReferenceLinks

Object

表示 REST 引用链接集合的类。

名称	类型	说明
links	object	链接的只读视图。 由于引用链接是只读的，因此我们只想将其公开为只读链接。

ResultState

枚举

测试点的最后结果状态

值	说明
completed	测试已完成，但没有定量的完成度量值。 这可能适用于负载测试。
inProgress	测试当前正在执行。
maxValue
paused	测试已暂停。 如果用户暂停测试用例（例如，手动测试人员可以暂停手动测试用例的执行），则此情况适用。
pending	测试位于执行队列中，尚未启动。
queued	测试已排队。 当测试用例排队执行时，这适用
unspecified	仅在更新期间使用以保留现有值。

TeamProjectReference

Object

表示对 TeamProject 的浅表引用。

名称	类型	说明
abbreviation	string	项目缩写。
defaultTeamImageUrl	string	指向默认团队标识映像的 URL。
description	string	项目的说明（如果有）。
id	string (uuid)	项目标识符。
lastUpdateTime	string (date-time)	上次更新时间的项目。
name	string	项目名称。
revision	integer (int64)	项目修订。
state	ProjectState	项目状态。
url	string	指向对象完整版本的 URL。
visibility	ProjectVisibility	项目可见性。

TestCaseReference

Object

测试用例参考

名称	类型	说明
assignedTo	IdentityRef	向其分配测试用例的标识
id	integer (int32)	测试用例 ID
name	string	测试用例名称
state	string	测试用例工作项的状态

TestConfigurationReference

Object

测试配置参考

名称	类型	说明
id	integer (int32)	配置的 ID
name	string	配置的名称

TestPlanReference

Object

测试计划参考资源。

名称	类型	说明
id	integer (int32)	测试计划的 ID。
name	string	测试计划的名称。

TestPoint

Object

Test Point 类

名称	类型	说明
comment	string	与测试点关联的注释
configuration	TestConfigurationReference	与测试点关联的配置
id	integer (int32)	测试点的 ID
isActive	boolean	用于确定测试用例是否处于活动状态的变量
isAutomated	boolean	自动测试用例或手动测试点
lastResetToActive	string (date-time)	上次重置为测试点的活动时间戳
lastUpdatedBy	IdentityRef	测试点的上次更新详细信息
lastUpdatedDate	string (date-time)	测试点的上次更新时间戳
links	ReferenceLinks	参考链接
project	TeamProjectReference	测试点所在的项目
results	TestPointResults	与测试点关联的结果
testCaseReference	TestCaseReference	测试用例参考
testPlan	TestPlanReference	测试点所在的测试计划
testSuite	TestSuiteReference	测试点所在的测试套件
tester	IdentityRef	与测试点关联的测试人员

TestPointResults

Object

测试结果

名称	类型	说明
failureType	FailureType	测试点的失败类型
lastResolutionState	LastResolutionState	测试点的最后一个解析状态 ID
lastResultDetails	LastResultDetails	测试点的最后一个结果详细信息
lastResultId	integer (int32)	最后一个结果 ID
lastResultState	ResultState	测试点的最后结果状态
lastRunBuildNumber	string	测试点的最后一个 RUn 内部版本号
lastTestRunId	integer (int32)	测试点的最后一个测试运行 ID
outcome	Outcome	测试点的结果
state	PointState	测试点的状态

TestSuiteReference

Object

测试套件参考资源。

名称	类型	说明
id	integer (int32)	测试套件的 ID。
name	string	测试套件的名称。