Results - Update

Service:

Test

API Version:

5.0

更新测试运行中的测试结果。

PATCH https://dev.azure.com/{organization}/{project}/_apis/test/Runs/{runId}/results?api-version=5.0

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
project	path	True	string	项目 ID 或项目名称
runId	path	True	integer int32	要更新其测试结果的测试运行 ID。
api-version	query	True	string	要使用的 API 版本。 应将其设置为“5.0”才能使用此版本的 API。

请求正文

名称	类型	说明
body	TestCaseResult[]	要更新的测试结果列表。

响应

名称	类型	说明
200 OK	TestCaseResult[]	成功的操作

安全性

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token 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

Scopes

名称	说明
vso.test_write	授予读取、创建和更新测试计划、案例、结果和其他测试管理相关项目的能力。

示例

Sample Request

HTTP

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-TFVC/_apis/test/Runs/26/results?api-version=5.0

[
  {
    "id": 100000,
    "state": "Completed",
    "comment": "Website theme is looking good",
    "associatedBugs": [
      {
        "id": 30
      }
    ]
  },
  {
    "id": 100001,
    "state": "Completed",
    "comment": "Website links are failing because of incorrect container id",
    "failureType": "Known Issue"
  }
]

Sample Response

Status code:

200

{
  "count": 2,
  "value": [
    {
      "id": 100000,
      "project": {},
      "testRun": {},
      "lastUpdatedBy": {
        "id": null
      },
      "url": ""
    },
    {
      "id": 100001,
      "project": {},
      "testRun": {},
      "lastUpdatedBy": {
        "id": null
      },
      "url": ""
    }
  ]
}

定义

名称	说明
BuildReference	对生成的引用。
CustomTestField	自定义字段信息。
FailingSince	由于测试结果的信息而失败。
IdentityRef
ReferenceLinks	表示 REST 引用链接集合的类。
ReleaseReference	对发布的引用。
ResultGroupType
ShallowReference	对某些其他资源的抽象引用。 此类用于提供生成数据协定，使用统一的方式引用其他资源，以便轻松遍历链接。
SharedStepModel	对共享步骤工作项的引用。
TestActionResultModel	表示测试步骤结果。
TestCaseResult	表示测试结果。
TestCaseResultAttachmentModel	测试迭代中的测试附件信息。
TestCaseResultIdentifier	对测试结果的引用。
TestIterationDetailsModel	表示测试迭代结果。
TestResultParameterModel	测试迭代中的测试参数信息。
TestSubResult	表示测试结果的子结果。

BuildReference

对生成的引用。

名称	类型	说明
branchName	string	分支名称。
buildSystem	string	生成系统。
definitionId	integer	生成定义 ID。
id	integer	生成 ID。
number	string	Build 号。
repositoryId	string	存储库 ID。
uri	string	生成 URI。

CustomTestField

自定义字段信息。

名称	类型	说明
fieldName	string	字段名称。
value	object	字段值。

FailingSince

由于测试结果的信息而失败。

名称	类型	说明
build	BuildReference	失败后生成引用。
date	string	失败后的时间。
release	ReleaseReference	失败后发布引用。

IdentityRef

名称	类型	说明
_links	ReferenceLinks	此字段包含有关图形主题的零个或多个相关链接。 可以调用这些链接来获取有关此图主题的其他关系或更多详细信息。
descriptor	string	描述符是在系统运行时引用图形主题的主要方式。 此字段将唯一标识帐户和组织中的同一图形主题。
directoryAlias	string
displayName	string	这是图形主题的非唯一显示名称。 若要更改此字段，必须在源提供程序中更改其值。
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	此 URL 是此图主题的源资源的完整路由。

ReferenceLinks

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

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

ReleaseReference

对发布的引用。

名称	类型	说明
attempt	integer
creationDate	string
definitionId	integer	发布定义 ID。
environmentCreationDate	string
environmentDefinitionId	integer	发布环境定义 ID。
environmentDefinitionName	string	发布环境定义名称。
environmentId	integer	发布环境 ID。
environmentName	string	发布环境名称。
id	integer	发布 ID。
name	string	版本名称。

ResultGroupType

名称	类型	说明
dataDriven	string	测试结果的层次结构类型。
generic	string	未知的层次结构类型。
none	string	测试结果的叶节点。
orderedTest	string	测试结果的层次结构类型。
rerun	string	测试结果的层次结构类型。

ShallowReference

对某些其他资源的抽象引用。 此类用于提供生成数据协定，使用统一的方式引用其他资源，以便轻松遍历链接。

名称	类型	说明
id	string	资源的 ID
name	string	链接资源的名称 (定义名称、控制器名称等)
url	string	指向资源的完整 http 链接

SharedStepModel

对共享步骤工作项的引用。

名称	类型	说明
id	integer	WorkItem 共享步骤 ID。
revision	integer	共享步骤工作项修订。

TestActionResultModel

表示测试步骤结果。

名称	类型	说明
actionPath	string	测试用例 workitem 中的路径标识符测试步骤。
comment	string	结果中的注释。
completedDate	string	执行完成的时间。
durationInMs	number	执行持续时间。
errorMessage	string	结果中的错误消息。
iterationId	integer	测试操作结果的迭代 ID。
outcome	string	结果的测试结果。
sharedStepModel	SharedStepModel	对共享步骤工作项的引用。
startedDate	string	开始执行的时间。
stepIdentifier	string	这是测试用例的步骤 ID。 对于共享步骤，它是测试用例 workitem 中共享步骤的步骤 ID;共享步骤中的步骤 ID。 示例：TestCase workitem 有两个步骤：1) Id = 1 2 的普通步骤) Id = 2 的共享步骤。 在共享步骤中：id = 1 的常规步骤) 第一步的 Value For StepIdentifier：“1”第二步：“2;1”
url	string	测试操作结果的 URL。

TestCaseResult

表示测试结果。

名称	类型	说明
afnStripId	integer	测试操作录制的附件 ID。
area	ShallowReference	对测试的区域路径的引用。
associatedBugs	ShallowReference[]	对链接到测试结果的 bug 的引用。
automatedTestId	string	表示 dll 中测试方法的 ID。
automatedTestName	string	执行的测试的完全限定名称。
automatedTestStorage	string	测试所属的容器。
automatedTestType	string	自动测试的类型。
automatedTestTypeId	string
build	ShallowReference	对与测试结果关联的生成的浅表引用。
buildReference	BuildReference	引用与测试结果关联的生成。
comment	string	在测试结果中注释。
completedDate	string	测试执行完成的时间。
computerName	string	执行测试的计算机名称。
configuration	ShallowReference	测试结果的测试配置。
createdDate	string	创建测试结果时的时间戳。
customFields	CustomTestField[]	测试结果的其他属性。
durationInMs	number	测试执行的持续时间（以毫秒为单位）。
errorMessage	string	测试执行中的错误消息。
failingSince	FailingSince	测试结果开始失败时的信息。
failureType	string	测试结果的失败类型。
id	integer	测试结果的 ID。
iterationDetails	TestIterationDetailsModel[]	测试迭代的测试结果详细信息。
lastUpdatedBy	IdentityRef	对标识上次更新的测试结果的引用。
lastUpdatedDate	string	测试结果的上次更新日期时间。
outcome	string	测试结果的测试结果。
owner	IdentityRef	对测试所有者的引用。
priority	integer	执行的测试的优先级。
project	ShallowReference	对团队项目的引用。
release	ShallowReference	对与测试结果关联的发布的浅表引用。
releaseReference	ReleaseReference	对与测试结果关联的发布的引用。
resetCount	integer
resolutionState	string	测试结果的解析状态。
resolutionStateId	integer	解析状态的 ID。
resultGroupType	ResultGroupType	结果的层次结构类型，默认值 None 表示其叶节点。
revision	integer	测试结果的修订号。
runBy	IdentityRef	对标识的引用执行了测试。
stackTrace	string	Stacktrace。
startedDate	string	测试执行开始的时间。
state	string	测试结果的状态。
subResults	TestSubResult[]	测试结果中的子结果列表，如果 ResultGroupType 不是“无”，则保存相应的类型子结果。
testCase	ShallowReference	对所执行测试的引用。
testCaseReferenceId	integer	测试结果使用的测试的引用 ID。
testCaseRevision	integer	测试的名称。
testCaseTitle	string	测试的名称。
testPlan	ShallowReference	对测试计划测试用例 workitem 的引用是 其中的一部分。
testPoint	ShallowReference	对执行的测试点的引用。
testRun	ShallowReference	对测试运行的引用。
testSuite	ShallowReference	对测试套件测试用例 workitem 的引用是 的一部分。
url	string	测试结果的 URL。

TestCaseResultAttachmentModel

测试迭代中的测试附件信息。

名称	类型	说明
actionPath	string	测试用例 workitem 中的路径标识符测试步骤。
id	integer	附件 ID。
iterationId	integer	迭代 ID。
name	string	附件的名称。
size	integer	附件大小。
url	string	附件的 URL。

TestCaseResultIdentifier

对测试结果的引用。

名称	类型	说明
testResultId	integer	测试结果 ID。
testRunId	integer	测试运行 ID。

TestIterationDetailsModel

表示测试迭代结果。

名称	类型	说明
actionResults	TestActionResultModel[]	测试步骤会导致迭代。
attachments	TestCaseResultAttachmentModel[]	在测试迭代结果中引用附件。
comment	string	测试迭代结果中的注释。
completedDate	string	执行完成的时间。
durationInMs	number	执行持续时间。
errorMessage	string	测试迭代结果执行中的错误消息。
id	integer	测试迭代结果的 ID。
outcome	string	如果测试迭代结果，则测试结果。
parameters	TestResultParameterModel[]	在迭代中测试参数。
startedDate	string	开始执行的时间。
url	string	测试迭代结果的 URL。

TestResultParameterModel

测试迭代中的测试参数信息。

名称	类型	说明
actionPath	string	引用参数的测试步骤路径。
iterationId	integer	迭代 ID。
parameterName	string	参数的名称，
stepIdentifier	string	这是测试用例的步骤 ID。 对于共享步骤，它是测试用例 workitem 中共享步骤的步骤 ID;共享步骤中的步骤 ID。 示例：TestCase workitem 有两个步骤：1) Id = 1 2 的普通步骤) Id = 2 的共享步骤。 在共享步骤中：id = 1 的常规步骤) 第一步的 Value For StepIdentifier：“1”第二步：“2;1”
url	string	测试参数的 URL。
value	string	参数的值。

TestSubResult

表示测试结果的子结果。

名称	类型	说明
comment	string	子结果中的注释。
completedDate	string	测试执行完成的时间。
computerName	string	执行测试的计算机。
configuration	ShallowReference	对测试配置的引用。
customFields	CustomTestField[]	子结果的其他属性。
displayName	string	子结果的名称。
durationInMs	integer	测试执行的持续时间。
errorMessage	string	子结果中的错误消息。
id	integer	子结果的 ID。
lastUpdatedDate	string	上次更新结果的时间。
outcome	string	子结果的结果。
parentId	integer	子结果的直接父 ID。
resultGroupType	ResultGroupType	结果的层次结构类型，默认值 None 表示其叶节点。
sequenceId	integer	子结果的索引号。
stackTrace	string	Stacktrace。
startedDate	string	测试执行开始的时间。
subResults	TestSubResult[]	子结果中的子结果列表，如果 ResultGroupType 不是“无”，则保存相应的类型子结果。
testResult	TestCaseResultIdentifier	对测试结果的引用。
url	string	子结果的 URL。