Results - Update

リファレンス

Service:: Test

API Version:: 7.1-preview.6

テストの実行でテスト結果を更新します。

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

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前です。
project	path	True	string	プロジェクト ID またはプロジェクト名
runId	path	True	integer int32	テスト結果を更新するテスト実行 ID。
api-version	query	True	string	使う API のバージョン。このバージョンの API を使用するには、これを '7.1-preview.6' に設定する必要があります。

要求本文

名前	型	説明
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=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

Status code:: 200

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

定義

名前	説明
BuildReference	ビルドへの参照。
CustomTestField	ユーザー設定フィールド情報。許可されるキー: 値のペア - ( AttemptId: int value, IsTestResultFlaky: bool)
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	ビルド番号。
repositoryId	string	リポジトリ ID。
uri	string	ビルド URI。

CustomTestField

ユーザー設定フィールド情報。許可されるキー: 値のペア - ( AttemptId: int value, IsTestResultFlaky: bool)

名前	型	説明
fieldName	string	フィールド名。
value	object	フィールド値。

FailingSince

テスト結果の情報以降に失敗する。

名前	型	説明
build	BuildReference	失敗後のビルド参照。
date	string	失敗してからの時間 (UTC)。
release	ReleaseReference	失敗後のリリース参照。

IdentityRef

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する 0 個以上の興味深いリンクが含まれています。これらのリンクを呼び出して、このグラフの主題に関する追加のリレーションシップや詳細情報を取得できます。
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	非推奨 - 記述子のサブジェクト型 (Descriptor.IsGroupType) から推論できます
isDeletedInOrigin	boolean
profileUrl	string	非推奨 - ToIdentityRef の既存のほとんどの実装では使用されていません
uniqueName	string	非推奨 - 代わりに Domain+PrincipalName を使用します
url	string	この URL は、このグラフの件名のソースリソースへの完全なルートです。

ReferenceLinks

REST 参照リンクのコレクションを表すクラス。

名前	型	説明
links	object	リンクの読み取り専用ビュー。参照リンクは読み取り専用であるため、参照リンクは読み取り専用として公開する必要があります。

ReleaseReference

リリースへの参照。

名前	型	説明
attempt	integer	リリース試行回数。
creationDate	string	リリースの作成日 (UTC)。
definitionId	integer	リリース定義 ID。
environmentCreationDate	string	環境の作成日 (UTC)。
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	テストケース作業項目のテストステップのパス識別子。注: 1) ステップの 8 桁の 16 進数形式で表されます。 2) 内部的には、最初のステップのステップ ID 値は 2 で始まるので、actionPath = 00000002 ステップ 9 は、ID = 10、actionPath = 000000a ステップ 15、ID =16、actionPath = 00000010 3) 共有ステップの actionPath がテストケースの親ステップと連結されます。たとえば、00000003はテストステップのアクションパスを示し、00000001は共有ステップのアクションパスを示す 0000000300000001 型になります。
comment	string	結果にコメントを付けます。
completedDate	string	実行が完了した時刻 (UTC)。
durationInMs	number	実行時間。
errorMessage	string	結果のエラーメッセージ。
iterationId	integer	テストアクションの結果のイテレーション ID。
outcome	string	結果のテスト結果。
sharedStepModel	SharedStepModel	共有ステップの作業項目への参照。
startedDate	string	実行が開始された時刻 (UTC)。
stepIdentifier	string	これはテストケースのステップ ID です。共有ステップの場合は、テストケース作業項目の共有ステップのステップ ID です。共有ステップのステップ ID。例: TestCase workitem には、2 つの手順があります。1) 通常のステップと ID = 1 2) 共有ステップと ID = 2。共有ステップ内: a) Id を持つ通常のステップ = 1 最初のステップの StepIdentifier の値: "1" 2 番目のステップ: "2;1"
url	string	テストアクションの結果の URL。ホストされた環境では非推奨です。

TestCaseResult

テスト結果を表します。

名前	型	説明
afnStripId	integer	アクション記録の添付ファイル ID をテストします。
area	ShallowReference	テストの領域パスへの参照。
associatedBugs	ShallowReference[]	テスト結果にリンクされているバグへの参照。
automatedTestId	string	dll 内のテストメソッドを表す ID。
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	テスト結果の ID。
iterationDetails	TestIterationDetailsModel[]	手動テストにのみ使用されるテストイテレーションのテスト結果の詳細。
lastUpdatedBy	IdentityRef	ID の最後に更新されたテスト結果への参照。
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	チームプロジェクトへの参照。
release	ShallowReference	テスト結果に関連付けられているリリースへの浅い参照。
releaseReference	ReleaseReference	テスト結果に関連付けられているリリースへの参照。
resetCount	integer	ResetCount。
resolutionState	string	テスト結果の解決状態。
resolutionStateId	integer	解決状態の ID。
resultGroupType	ResultGroupType	結果の階層の種類。既定値の None はリーフノードを意味します。
revision	integer	テスト結果のリビジョン番号。
runBy	IdentityRef	テストを実行した ID への参照。
stackTrace	string	maxSize= 1000 文字の Stacktrace。
startedDate	string	テスト実行が開始された時刻 (UTC)。
state	string	テスト結果の状態。「TestRunState」と入力します。
subResults	TestSubResult[]	テスト結果内のサブ結果の一覧。ResultGroupType が None でない場合は、対応する型サブ結果が保持されます。
testCase	ShallowReference	実行されたテストへの参照。
testCaseReferenceId	integer	テスト結果で使用されるテストの参照 ID。 TestResultMetaData 型
testCaseRevision	integer	TestCaseRevision Number。
testCaseTitle	string	テストの名前。
testPlan	ShallowReference	テスト計画テストケースの作業項目への参照はの一部です。
testPoint	ShallowReference	実行されたテストポイントへの参照。
testRun	ShallowReference	テスト実行への参照。
testSuite	ShallowReference	テストスイートのテストケースの作業項目への参照はの一部です。
url	string	テスト結果の URL。

TestCaseResultAttachmentModel

テストイテレーションの添付ファイル情報をテストします。

名前	型	説明
actionPath	string	テストケースの作業項目のパス識別子テストステップ。
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	実行が完了した時刻 (UTC)。
durationInMs	number	実行時間。
errorMessage	string	テストイテレーションの結果の実行のエラーメッセージ。
id	integer	テストイテレーション結果の ID。
outcome	string	テストイテレーションの結果をテストする場合は、結果をテストします。
parameters	TestResultParameterModel[]	イテレーションでパラメーターをテストします。
startedDate	string	実行が開始された時刻 (UTC)。
url	string	反復結果をテストするための URL。

TestResultParameterModel

テストイテレーションのテストパラメーター情報。

名前	型	説明
actionPath	string	パラメーターが参照されるテストステップパス。
iterationId	integer	イテレーション ID。
parameterName	string	パラメーターの名前。
stepIdentifier	string	これはテストケースのステップ ID です。共有ステップの場合は、テストケース作業項目の共有ステップのステップ ID です。共有ステップのステップ ID。例: TestCase workitem には、2 つの手順があります。1) 通常のステップと ID = 1 2) 共有ステップと ID = 2。共有ステップ内: a) Id を持つ通常のステップ = 1 最初のステップの StepIdentifier の値: "1" 2 番目のステップ: "2;1"
url	string	テストパラメーターの URL。ホストされた環境では非推奨です。
value	string	パラメーターの値。

TestSubResult

テスト結果のサブ結果を表します。

名前	型	説明
comment	string	サブ結果のコメント。
completedDate	string	テスト実行が完了した時刻 (UTC)。
computerName	string	テストが実行されたマシン。
configuration	ShallowReference	テスト構成への参照。
customFields	CustomTestField[]	サブ結果の追加プロパティ。
displayName	string	サブ結果の名前。
durationInMs	integer	テスト実行の期間。
errorMessage	string	サブ結果のエラーメッセージ。
id	integer	サブ結果の ID。
lastUpdatedDate	string	結果が最後に更新された時刻 (UTC)。
outcome	string	サブ結果の結果。
parentId	integer	サブ結果の直接親 ID。
resultGroupType	ResultGroupType	結果の階層の種類。既定値の None はリーフノードを意味します。
sequenceId	integer	サブ結果のインデックス番号。
stackTrace	string	Stacktrace。
startedDate	string	テスト実行が開始された時刻 (UTC)。
subResults	TestSubResult[]	サブ結果内のサブ結果の一覧。ResultGroupType が None でない場合は、対応する型 sub 結果が保持されます。
testResult	TestCaseResultIdentifier	テスト結果への参照。
url	string	サブ結果の URL。

次の方法で共有