Clone Operation - Clone Test Plan

リファレンス

サービス:: Test

API バージョン:: 5.0-preview.2

テスト計画の複製

POST https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/cloneoperation?api-version=5.0-preview.2

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前です。
planId	path	True	integer int32	複製するテスト計画の ID。
project	path	True	string	プロジェクト ID またはプロジェクト名
api-version	query	True	string	使う API のバージョン。このバージョンの API を使用するには、これを '5.0-preview.2' に設定する必要があります。

要求本文

名前	型	説明
destinationTestPlan	TestPlan	テスト計画リソース。
options	CloneOptions
suiteIds	integer[]

応答

名前	型	説明
200 OK	CloneOperationInformation	成功した操作

セキュリティ

oauth2

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL (トークン 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_write	テスト計画、ケース、結果、その他のテスト管理関連の成果物を読み取り、作成、更新する機能を付与します。

例

要求のサンプル

HTTP

POST https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/cloneoperation?api-version=5.0-preview.2

{
  "destinationTestPlan": {
    "name": "DestinationSuite",
    "Project": {
      "Name": "fabrikam-fiber-tfvc2"
    }
  },
  "options": {
    "copyAncestorHierarchy": true,
    "copyAllSuites": true,
    "overrideParameters": {
      "System.AreaPath": "fabrikam-fiber-tfvc2",
      "System.IterationPath": "fabrikam-fiber-tfvc2"
    }
  },
  "suiteIds": [
    2
  ]
}

応答のサンプル

状態コード:: 200

{
  "opId": 2,
  "creationDate": "0001-01-01T00:00:00",
  "completionDate": "0001-01-01T00:00:00",
  "state": "queued",
  "message": null,
  "cloneStatistics": null,
  "resultObjectType": "testPlan",
  "destinationObject": {
    "id": "18",
    "name": "DestinationPlan",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc2/_apis/test/Plans/18"
  },
  "sourceObject": {
    "id": "1",
    "name": "TestPlan1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "destinationPlan": {
    "id": "18",
    "name": "DestinationPlan",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc2/_apis/test/Plans/18"
  },
  "sourcePlan": {
    "id": "1",
    "name": "TestPlan1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
  },
  "destinationProject": {
    "name": "fabrikam-fiber-tfvc2",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/fabrikam-fiber-tfvc2"
  },
  "sourceProject": {
    "name": "fabrikam-fiber-tfvc",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/fabrikam-fiber-tfvc"
  },
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/cloneOperation/2"
}

定義

名前	説明
CloneOperationInformation	複製操作の詳細。
CloneOperationState	操作の現在の状態。 State が Suceeded または Failed に達すると、操作は完了します
CloneOptions
CloneStatistics
IdentityRef
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
ReleaseEnvironmentDefinitionReference	リリース環境リソースへの参照。
ResultObjectType	Clone 操作の結果として生成されるオブジェクトの型
ShallowReference	他のリソースへの抽象化された参照。このクラスは、リンクを介して簡単に走査できる方法で他のリソースを参照する一様な方法でビルドデータコントラクトを提供するために使用されます。
TestOutcomeSettings	テスト結果の設定
TestPlan	テスト計画リソース。
TestPlanCloneRequest

CloneOperationInformation

Object

複製操作の詳細。

名前	型	説明
cloneStatistics	CloneStatistics	統計の複製
completionDate	string	操作が完了した場合、完了の DateTime。操作が完了していない場合、これは DateTime.MaxValue です
creationDate	string	操作が開始されたときの DateTime
destinationObject	ShallowReference	宛先の浅い参照
destinationPlan	ShallowReference	宛先の浅い参照
destinationProject	ShallowReference	宛先の浅い参照
message	string	操作が失敗した場合、メッセージにはエラーの理由が含まれます。その他の場合は NULL が返されます。
opId	integer	操作の ID
resultObjectType	ResultObjectType	Clone 操作の結果として生成されるオブジェクトの型
sourceObject	ShallowReference	ソースの浅い参照
sourcePlan	ShallowReference	ソースの浅い参照
sourceProject	ShallowReference	ソースの浅い参照
state	CloneOperationState	操作の現在の状態。 State が Suceeded または Failed に達すると、操作は完了します
url	string	複製情報を取得するための URL

CloneOperationState

列挙

操作の現在の状態。 State が Suceeded または Failed に達すると、操作は完了します

値	説明
failed	Failed State の値
inProgress	Inprogress 状態の値
queued	キュー状態の値
succeeded	成功状態の値

CloneOptions

Object

名前	型	説明
cloneRequirements	boolean	true に設定すると、要件が複製されます
copyAllSuites	boolean	ソースプランからすべてのスイートをコピーする
copyAncestorHierarchy	boolean	copy 先祖 hieracrchy
destinationWorkItemType	string	複製の作業項目タイプの名前
overrideParameters	object	キー値が値によってオーバーライドされるキー値のペア。
relatedLinkComment	string	新しい複製テストケースを元の Set null にリンクするリンクにコメントを付けます。コメントなし

CloneStatistics

Object

名前	型	説明
clonedRequirementsCount	integer	これまでに複製された要求の数。
clonedSharedStepsCount	integer	これまでに複製された共有ステップの数。
clonedTestCasesCount	integer	これまでに複製されたテストケースの数
totalRequirementsCount	integer	複製する要件の合計数
totalTestCasesCount	integer	複製するテストケースの合計数

IdentityRef

Object

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する 0 個以上の興味深いリンクが含まれています。これらのリンクを呼び出して、このグラフの件名に関する追加のリレーションシップまたは詳細情報を取得できます。
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

Object

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

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

ReleaseEnvironmentDefinitionReference

Object

リリース環境リソースへの参照。

名前	型	説明
definitionId	integer	リリース環境定義を含むリリース定義の ID。
environmentDefinitionId	integer	リリース環境定義の ID。

ResultObjectType

列挙

Clone 操作の結果として生成されるオブジェクトの型

値	説明
testPlan	計画の複製
testSuite	Suite Clone

ShallowReference

Object

他のリソースへの抽象化された参照。このクラスは、リンクを介して簡単に走査できる方法で他のリソースを参照する一様な方法でビルドデータコントラクトを提供するために使用されます。

名前	型	説明
id	string	リソースの ID
name	string	リンクされたリソースの名前 (定義名、コントローラー名など)
url	string	リソースへの完全な http リンク

TestOutcomeSettings

Object

テスト結果の設定

名前	型	説明
syncOutcomeAcrossSuites	boolean	スイート間で同じテストのテスト結果を表示する方法を構成する値

TestPlan

Object

テスト計画リソース。

名前	型	説明
area	ShallowReference	テスト計画の領域。
build	ShallowReference	テストするビルド。
buildDefinition	ShallowReference	このテスト計画に関連付けられたビルドを生成するビルド定義。
description	string	テスト計画の説明。
endDate	string	テスト計画の終了日。
id	integer	テスト計画の ID。
iteration	string	テスト計画のイテレーションパス。
name	string	テスト計画の名前。
owner	IdentityRef	テスト計画の所有者。
previousBuild	ShallowReference	他のリソースへの抽象化された参照。このクラスは、リンクを介して簡単に走査できる方法で他のリソースを参照する一様な方法でビルドデータコントラクトを提供するために使用されます。
project	ShallowReference	テスト計画を含むプロジェクト。
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	ビルドをデプロイし、このテスト計画から自動テストを実行するために使用するリリース環境。
revision	integer	テスト計画の改訂。
rootSuite	ShallowReference	テスト計画のルートテストスイート。
startDate	string	テスト計画の開始日。
state	string	テスト計画の状態。
testOutcomeSettings	TestOutcomeSettings	テスト計画の下でテストスイート間で同じテストを動作させる方法を構成する値
updatedBy	IdentityRef
updatedDate	string
url	string	テスト計画リソースの URL。

TestPlanCloneRequest

Object

名前	型	説明
destinationTestPlan	TestPlan	テスト計画リソース。
options	CloneOptions
suiteIds	integer[]

次の方法で共有

Clone Operation - Clone Test Plan

URI パラメーター

要求本文

応答

セキュリティ

oauth2

スコープ

例

要求のサンプル

応答のサンプル

定義

CloneOperationInformation

CloneOperationState

CloneOptions

CloneStatistics

IdentityRef

ReferenceLinks

ReleaseEnvironmentDefinitionReference

ResultObjectType

ShallowReference

TestOutcomeSettings

TestPlan

TestPlanCloneRequest