Test Plan Clone - Clone Test Plan

リファレンス

サービス:: Test Plan

API バージョン:: 7.1

テスト計画の複製

POST https://dev.azure.com/{organization}/{project}/_apis/testplan/Plans/CloneOperation?api-version=7.1

省略可能なパラメーターを含む:

POST https://dev.azure.com/{organization}/{project}/_apis/testplan/Plans/CloneOperation?deepClone={deepClone}&api-version=7.1

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前。
project	path	True	string	プロジェクト ID またはプロジェクト名
api-version	query	True	string	使用する API のバージョン。このバージョンの API を使用するには、これを '7.1' に設定する必要があります。
deepClone	query		boolean	関連するすべてのテストケースも複製します

要求本文

名前	型	説明
cloneOptions	CloneOptions	テスト計画複製の作成パラメーター
destinationTestPlan	DestinationTestPlanCloneParams	移行先のテスト計画に関する情報
sourceTestPlan	SourceTestPlanInfo	ソーステスト計画に関する情報

応答

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

セキュリティ

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	テスト計画、ケース、結果、その他のテスト管理関連成果物の読み取り、作成、更新を行う機能を付与します。

定義

名前	説明
BuildDefinitionReference	ビルド定義参照リソース
CloneOperationCommonResponse	複製操作の一般的な応答
CloneOperationState	複製操作の状態
CloneOptions	テストスイートを複製するための複製オプション。
CloneStatistics	統計の詳細を複製します。
CloneTestPlanOperationInformation	テスト計画の複製操作に対する応答
CloneTestPlanParams	テスト計画の複製操作のパラメーター
DestinationTestPlanCloneParams	宛先テスト計画のパラメーターの作成
IdentityRef
ProjectState	プロジェクトの状態。
ProjectVisibility	プロジェクトの可視性。
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
ReleaseEnvironmentDefinitionReference	リリース環境リソースへの参照。
SourceTestPlanInfo	テスト計画の複製操作のソーステスト計画情報
SourceTestplanResponse	テスト計画の複製操作のソーステスト計画応答
TeamProjectReference	TeamProject への浅い参照を表します。
TestOutcomeSettings	テスト結果の設定
TestPlan	テスト計画リソース。
TestSuiteReference	テストスイート参照リソース。

BuildDefinitionReference

Object

ビルド定義参照リソース

名前	型	説明
id	integer (int32)	ビルド定義の ID
name	string	ビルド定義の名前

CloneOperationCommonResponse

Object

複製操作の一般的な応答

名前	型	説明
cloneStatistics	CloneStatistics	複製操作に関連するさまざまな統計
completionDate	string (date-time)	操作の完了データ
creationDate	string (date-time)	操作の作成データ
links	ReferenceLinks	参照リンク
message	string	ジョブに関連するメッセージ
opId	integer (int32)	複製操作 ID
state	CloneOperationState	複製操作の状態

CloneOperationState

列挙

複製操作の状態

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

CloneOptions

Object

テストスイートを複製するための複製オプション。

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

CloneStatistics

Object

統計の詳細を複製します。

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

CloneTestPlanOperationInformation

Object

テスト計画の複製操作に対する応答

名前	型	説明
cloneOperationResponse	CloneOperationCommonResponse	クローンに関連するさまざまな情報
cloneOptions	CloneOptions	テスト計画複製の作成パラメーター
destinationTestPlan	TestPlan	移行先テスト計画の情報
sourceTestPlan	SourceTestplanResponse	ソーステスト計画の情報

CloneTestPlanParams

Object

テスト計画の複製操作のパラメーター

名前	型	説明
cloneOptions	CloneOptions	テスト計画複製の作成パラメーター
destinationTestPlan	DestinationTestPlanCloneParams	移行先のテスト計画に関する情報
sourceTestPlan	SourceTestPlanInfo	ソーステスト計画に関する情報

DestinationTestPlanCloneParams

Object

宛先テスト計画のパラメーターの作成

名前	型	説明
areaPath	string	テスト計画の領域。
buildDefinition	BuildDefinitionReference	このテスト計画に関連付けられたビルドを生成するビルド定義。
buildId	integer (int32)	テスト対象のビルド。
description	string	テスト計画の説明。
endDate	string (date-time)	テスト計画の終了日。
iteration	string	テスト計画のイテレーションパス。
name	string	テスト計画の名前。
owner	IdentityRef	テスト計画の所有者。
project	string	変換先プロジェクト名
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	ビルドをデプロイし、このテスト計画から自動テストを実行するために使用されるリリース環境。
startDate	string (date-time)	テスト計画の開始日。
state	string	テスト計画の状態。
testOutcomeSettings	TestOutcomeSettings	テスト計画の下でテストスイート間で同じテストを実行する必要がある方法を構成する値

IdentityRef

Object

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する興味深いリンクが 0 個以上含まれています。これらのリンクを呼び出して、このグラフの件名に関する追加のリレーションシップや詳細情報を取得できます。
descriptor	string	記述子は、システムの実行中にグラフの件名を参照する主な方法です。このフィールドは、アカウントと組織の両方で同じグラフの件名を一意に識別します。
directoryAlias	string	非推奨 - IdentityRef "_links" ディクショナリの "自己" エントリで参照されている 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 は、このグラフの件名のソースリソースへの完全なルートです。

ProjectState

列挙

プロジェクトの状態。

値	説明
all	[削除済み] を除く、状態に関係なく、すべてのプロジェクト。
createPending	プロジェクトは作成のためにキューに登録されていますが、プロセスはまだ開始されていません。
deleted	プロジェクトが削除されました。
deleting	プロジェクトは削除中です。
new	プロジェクトは作成中です。
unchanged	プロジェクトは変更されていません。
wellFormed	プロジェクトが完全に作成され、使用する準備が整いました。

ProjectVisibility

列挙

プロジェクトの可視性。

値	説明
private	プロジェクトは、明示的なアクセス権を持つユーザーにのみ表示されます。
public	プロジェクトはすべてのユーザーに表示されます。

ReferenceLinks

Object

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

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

ReleaseEnvironmentDefinitionReference

Object

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

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

SourceTestPlanInfo

Object

テスト計画の複製操作のソーステスト計画情報

名前	型	説明
id	integer (int32)	ソーステスト計画の ID
suiteIds	integer[] (int32)	ソーステスト計画内に複製されるスイートの ID

SourceTestplanResponse

Object

テスト計画の複製操作のソーステスト計画応答

名前	型	説明
id	integer (int32)	テスト計画の ID。
name	string	テスト計画の名前。
project	TeamProjectReference	プロジェクトリファレンス
suiteIds	integer[] (int32)	ソーステスト計画内に複製されるスイートの ID

TeamProjectReference

Object

TeamProject への浅い参照を表します。

名前	型	説明
abbreviation	string	プロジェクトの省略形。
defaultTeamImageUrl	string	既定のチーム ID イメージの URL。
description	string	プロジェクトの説明 (ある場合)。
id	string (uuid)	プロジェクト識別子。
lastUpdateTime	string (date-time)	プロジェクトの最終更新時刻。
name	string	プロジェクト名。
revision	integer (int64)	プロジェクトのリビジョン。
state	ProjectState	プロジェクトの状態。
url	string	オブジェクトの完全なバージョンへの URL。
visibility	ProjectVisibility	プロジェクトの可視性。

TestOutcomeSettings

Object

テスト結果の設定

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

TestPlan

Object

テスト計画リソース。

名前	型	説明
_links	ReferenceLinks	関連するリンク
areaPath	string	テスト計画の領域。
buildDefinition	BuildDefinitionReference	このテスト計画に関連付けられたビルドを生成するビルド定義。
buildId	integer (int32)	テスト対象のビルド。
description	string	テスト計画の説明。
endDate	string (date-time)	テスト計画の終了日。
id	integer (int32)	テスト計画の ID。
iteration	string	テスト計画のイテレーションパス。
name	string	テスト計画の名前。
owner	IdentityRef	テスト計画の所有者。
previousBuildId	integer (int32)	テスト計画に関連付けられている以前のビルド ID
project	TeamProjectReference	テスト計画を含むプロジェクト。
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	ビルドをデプロイし、このテスト計画から自動テストを実行するために使用されるリリース環境。
revision	integer (int32)	テスト計画の改訂。
rootSuite	TestSuiteReference	テスト計画のルートテストスイート。
startDate	string (date-time)	テスト計画の開始日。
state	string	テスト計画の状態。
testOutcomeSettings	TestOutcomeSettings	テスト計画の下でテストスイート間で同じテストを実行する必要がある方法を構成する値
updatedBy	IdentityRef	テスト計画の最後の更新の ID リファレンス
updatedDate	string (date-time)	テスト計画の更新日

TestSuiteReference

Object

テストスイート参照リソース。

名前	型	説明
id	integer (int32)	テストスイートの ID。
name	string	テストスイートの名前。

次の方法で共有

Test Plan Clone - Clone Test Plan

URI パラメーター

要求本文

応答

セキュリティ

oauth2

スコープ

定義

BuildDefinitionReference

CloneOperationCommonResponse

CloneOperationState

CloneOptions

CloneStatistics

CloneTestPlanOperationInformation

CloneTestPlanParams

DestinationTestPlanCloneParams

IdentityRef

ProjectState

ProjectVisibility

ReferenceLinks

ReleaseEnvironmentDefinitionReference

SourceTestPlanInfo

SourceTestplanResponse

TeamProjectReference

TestOutcomeSettings

TestPlan

TestSuiteReference