共用方式為


Results - Update

更新測試回合中的測試結果。

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

URI 參數

名稱 位於 必要 類型 Description
organization
path True

string

Azure DevOps 組織的名稱。

project
path True

string

專案識別碼或專案名稱

runId
path True

integer

int32

要更新其測試結果的測試回合識別碼。

api-version
query True

string

要使用的 API 版本。 這應該設定為 '7.1-preview.6' 以使用此版本的 API。

要求本文

名稱 類型 Description
body

TestCaseResult[]

要更新的測試結果清單。

回應

名稱 類型 Description
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

名稱 Description
vso.test_write 授與讀取、建立及更新測試計劃、案例、結果和其他測試管理相關成品的能力。

範例

Sample Request

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

[
  {
    "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

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

定義

名稱 Description
BuildReference

組建的參考。

CustomTestField

自訂欄位資訊。 允許的索引鍵:值組 - ( AttemptId:int 值、IsTestResultFlaky:bool)

FailingSince

失敗,因為測試結果的資訊。

IdentityRef
ReferenceLinks

表示 REST 參考連結集合的類別。

ReleaseReference

發行的參考。

ResultGroupType
ShallowReference

一些其他資源的抽象參考。 這個類別可用來提供建置資料合約,以統一方式參考其他資源,以提供輕鬆周遊連結的方式。

SharedStepModel

共用步驟工作專案的參考。

TestActionResultModel

表示測試步驟結果。

TestCaseResult

表示測試結果。

TestCaseResultAttachmentModel

測試反復專案中的測試附件資訊。

TestCaseResultIdentifier

測試結果的參考。

TestIterationDetailsModel

表示測試反復專案結果。

TestResultParameterModel

測試反復專案中的測試參數資訊。

TestSubResult

表示測試結果的子結果。

BuildReference

組建的參考。

名稱 類型 Description
branchName

string

分支名稱。

buildSystem

string

建置系統。

definitionId

integer

組建定義識別碼。

id

integer

組建識別碼。

number

string

組建編號。

repositoryId

string

存放庫識別碼。

uri

string

建置 URI。

CustomTestField

自訂欄位資訊。 允許的索引鍵:值組 - ( AttemptId:int 值、IsTestResultFlaky:bool)

名稱 類型 Description
fieldName

string

欄位名稱。

value

object

域值。

FailingSince

失敗,因為測試結果的資訊。

名稱 類型 Description
build

BuildReference

建置參考,因為失敗。

date

string

自 UTC) 失敗 (以來的時間。

release

ReleaseReference

發行參考,因為失敗。

IdentityRef

名稱 類型 Description
_links

ReferenceLinks

此欄位包含有關圖表主旨的零個或多個有趣連結。 您可以叫用這些連結來取得其他關聯性,或取得此圖表主體的詳細資訊。

descriptor

string

描述項是在系統執行時參考圖形主旨的主要方式。 此欄位可唯一識別帳戶和組織之間的相同圖表主旨。

directoryAlias

string

已淘汰 - 藉由查詢 IdentityRef 「_links」 字典之 「self」 專案中參考的 Graph 使用者,即可擷取

displayName

string

這是圖表主旨的非唯一顯示名稱。 若要變更此欄位,您必須在來源提供者中變更其值。

id

string

imageUrl

string

已淘汰 - 可在 IdentityRef 「_links」 字典的 「avatar」 專案中使用

inactive

boolean

已淘汰 - 您可以查詢 GraphUser 「_links」 字典的 「membershipState」 專案中參考的 Graph 成員資格狀態來擷取

isAadIdentity

boolean

已被取代 - 可以從描述元的主旨類型推斷 (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

已被取代 - 可以從描述元的主旨類型推斷 (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

已淘汰 - 不在 ToIdentityRef 的大多數既有實作中使用

uniqueName

string

已淘汰 - 請改用 Domain+PrincipalName

url

string

此 URL 是此圖表主體來源資源的完整路由。

表示 REST 參考連結集合的類別。

名稱 類型 Description
links

object

連結的唯讀檢視。 因為參考連結是唯讀的,所以我們只想要將它們公開為唯讀。

ReleaseReference

發行的參考。

名稱 類型 Description
attempt

integer

發行嘗試次數。

creationDate

string

發行建立日期 (UTC) 。

definitionId

integer

發行定義識別碼。

environmentCreationDate

string

環境建立日期 (UTC) 。

environmentDefinitionId

integer

發行環境定義識別碼。

environmentDefinitionName

string

發行環境定義名稱。

environmentId

integer

發行環境識別碼。

environmentName

string

發行環境名稱。

id

integer

版本識別碼。

name

string

發行版本名稱。

ResultGroupType

名稱 類型 Description
dataDriven

string

測試結果的階層類型。

generic

string

未知的階層類型。

none

string

測試結果的分葉節點。

orderedTest

string

測試結果的階層類型。

rerun

string

測試結果的階層類型。

ShallowReference

一些其他資源的抽象參考。 這個類別可用來提供建置資料合約,以統一方式參考其他資源,以提供輕鬆周遊連結的方式。

名稱 類型 Description
id

string

資源的識別碼

name

string

連結資源的名稱 (定義名稱、控制器名稱等。)

url

string

資源的完整 HTTP 連結

SharedStepModel

共用步驟工作專案的參考。

名稱 類型 Description
id

integer

WorkItem 共用步驟識別碼。

revision

integer

共用步驟工作專案修訂。

TestActionResultModel

表示測試步驟結果。

名稱 類型 Description
actionPath

string

測試案例工作專案中測試步驟的路徑識別碼。 注意:1) 以十六進位格式來表示步驟的 8 位數。 2) 內部,第一個步驟的步驟識別碼值從 2 開始,因此 actionPath = 00000002步驟 9,識別碼 = 10 且 actionPath = 0000000a 步驟 15 會具有識別碼 =16 且 actionPath = 00000010 3) shared 步驟的 actionPath 會與測試案例的父步驟串連。 例如,其類型為 - 0000000300000001其中00000003代表測試步驟的移動路徑,00000001表示共用步驟的移動路徑

comment

string

結果中的批註。

completedDate

string

執行完成的時間 (UTC) 。

durationInMs

number

執行持續時間。

errorMessage

string

結果中的錯誤訊息。

iterationId

integer

測試動作結果的反復專案識別碼。

outcome

string

結果的測試結果。

sharedStepModel

SharedStepModel

共用步驟工作專案的參考。

startedDate

string

執行開始的時間 (UTC) 。

stepIdentifier

string

這是測試案例的步驟識別碼。 針對共用步驟,它是測試案例工作專案中共用步驟的步驟識別碼;共用步驟中的步驟識別碼。 範例:TestCase workitem 有兩個步驟:1 個) 一般步驟,識別碼 = 1 2) 共用步驟識別碼 = 2。 在共用步驟內:具有識別碼的) 一般步驟 = 第一個步驟的 StepIdentifier 值為 1:「1」 第二個步驟:「2;1」

url

string

測試動作結果的 URL。 在託管環境中已被取代。

TestCaseResult

表示測試結果。

名稱 類型 Description
afnStripId

integer

測試動作錄製的附件識別碼。

area

ShallowReference

測試區域路徑的參考。

associatedBugs

ShallowReference[]

連結至測試結果之 Bug 的參考。

automatedTestId

string

代表 dll 中測試方法的識別碼。

automatedTestName

string

執行之測試的完整名稱。

automatedTestStorage

string

測試所屬的容器。

automatedTestType

string

自動化測試的類型。

automatedTestTypeId

string

自動化測試的 TypeId。

build

ShallowReference

與測試結果相關聯的建置淺層參考。

buildReference

BuildReference

與測試結果相關聯的組建參考。

comment

string

在具有 maxSize= 1000 個字元的測試結果中加上批註。

completedDate

string

測試執行完成的時間 (UTC) 。 完成日期應大於 StartedDate。

computerName

string

執行測試的電腦名稱稱。

configuration

ShallowReference

測試組態的參考。 輸入 ShallowReference。

createdDate

string

(UTC) 建立測試結果時的時間戳記。

customFields

CustomTestField[]

測試結果的其他屬性。

durationInMs

number

以毫秒為單位的測試執行持續時間。 如果未提供值,則會設定為 CompletedDate - StartedDate

errorMessage

string

測試執行中的錯誤訊息。

failingSince

FailingSince

測試結果啟動失敗時的資訊。

failureType

string

測試結果失敗類型。 有效值= (已知問題、新問題、回歸、未知、無)

id

integer

測試結果的識別碼。

iterationDetails

TestIterationDetailsModel[]

測試反復專案僅用於手動測試的測試結果詳細資料。

lastUpdatedBy

IdentityRef

上次更新測試結果的身分識別參考。

lastUpdatedDate

string

上次更新的測試結果日期時間 (UTC) 。

outcome

string

測試結果的測試結果。 有效值 = (Unspecified、None、Passed、Failed、Inconclusive、Timeout、Aborted、Blocked、NotExecuted、Warning、Error、NotApplicable、Paused、InProgress、NotImpacted)

owner

IdentityRef

測試擁有者的參考。

priority

integer

執行測試的優先順序。

project

ShallowReference

Team 專案的參考。

release

ShallowReference

與測試結果相關聯的發行淺層參考。

releaseReference

ReleaseReference

與測試結果相關聯的發行參考。

resetCount

integer

ResetCount。

resolutionState

string

測試結果的解析狀態。

resolutionStateId

integer

解析狀態的識別碼。

resultGroupType

ResultGroupType

結果的階層類型,預設值 None 表示其分葉節點。

revision

integer

測試結果的修訂編號。

runBy

IdentityRef

身分識別的參考已執行測試。

stackTrace

string

具有 maxSize= 1000 個字元的 Stacktrace。

startedDate

string

測試執行開始的時間 (UTC) 。

state

string

測試結果的狀態。 輸入 TestRunState。

subResults

TestSubResult[]

測試結果內的子結果清單,如果 ResultGroupType 不是 None,則會保留對應的類型子結果。

testCase

ShallowReference

執行之測試的參考。

testCaseReferenceId

integer

測試結果所使用的測試參考識別碼。 輸入 TestResultMetaData

testCaseRevision

integer

TestCaseRevision Number。

testCaseTitle

string

測試的名稱。

testPlan

ShallowReference

測試計劃測試案例工作的參考是的一部分。

testPoint

ShallowReference

執行之測試點的參考。

testRun

ShallowReference

測試回合的參考。

testSuite

ShallowReference

測試套件測試案例工作的參考是的一部分。

url

string

測試結果的 URL。

TestCaseResultAttachmentModel

測試反復專案中的測試附件資訊。

名稱 類型 Description
actionPath

string

測試案例工作專案中的路徑識別碼測試步驟。

id

integer

附件識別碼。

iterationId

integer

反復專案識別碼。

name

string

附件的名稱。

size

integer

附件大小。

url

string

附件的 URL。

TestCaseResultIdentifier

測試結果的參考。

名稱 類型 Description
testResultId

integer

測試結果識別碼。

testRunId

integer

測試回合識別碼。

TestIterationDetailsModel

表示測試反復專案結果。

名稱 類型 Description
actionResults

TestActionResultModel[]

測試步驟會產生反復專案。

attachments

TestCaseResultAttachmentModel[]

測試反復專案結果中附件的參考。

comment

string

測試反復專案結果中的批註。

completedDate

string

執行完成的時間 (UTC) 。

durationInMs

number

執行持續時間。

errorMessage

string

測試反復專案結果執行中的錯誤訊息。

id

integer

測試反復專案結果的識別碼。

outcome

string

測試反復專案結果是否為測試結果。

parameters

TestResultParameterModel[]

反復專案中的測試參數。

startedDate

string

執行開始的時間 (UTC) 。

url

string

測試反復專案結果的 URL。

TestResultParameterModel

測試反復專案中的測試參數資訊。

名稱 類型 Description
actionPath

string

參考參數的測試步驟路徑。

iterationId

integer

反復專案識別碼。

parameterName

string

參數的名稱。

stepIdentifier

string

這是測試案例的步驟識別碼。 針對共用步驟,它是測試案例工作專案中共用步驟的步驟識別碼;共用步驟中的步驟識別碼。 範例:TestCase workitem 有兩個步驟:1 個) 一般步驟,識別碼 = 1 2) 共用步驟識別碼 = 2。 在共用步驟內:具有識別碼的) 一般步驟 = 第一個步驟的 StepIdentifier 值為 1:「1」 第二個步驟:「2;1」

url

string

測試參數的 URL。 在託管環境中已被取代。

value

string

參數的值。

TestSubResult

表示測試結果的子結果。

名稱 類型 Description
comment

string

子結果中的批註。

completedDate

string

測試執行完成的時間 (UTC) 。

computerName

string

執行測試的電腦。

configuration

ShallowReference

測試組態的參考。

customFields

CustomTestField[]

子結果的其他屬性。

displayName

string

子結果的名稱。

durationInMs

integer

測試執行的持續時間。

errorMessage

string

子結果中的錯誤訊息。

id

integer

子結果的識別碼。

lastUpdatedDate

string

結果上次更新的時間 (UTC) 。

outcome

string

子結果的結果。

parentId

integer

子結果的立即父識別碼。

resultGroupType

ResultGroupType

結果的階層類型,預設值 None 表示其分葉節點。

sequenceId

integer

子結果的索引編號。

stackTrace

string

Stacktrace。

startedDate

string

測試執行開始的時間 (UTC) 。

subResults

TestSubResult[]

子結果內的子結果清單,如果 ResultGroupType 不是 None,則會保留對應的類型子結果。

testResult

TestCaseResultIdentifier

測試結果的參考。

url

string

子結果的 URL。