Test Plan Clone - Clone Test Plan

參考

Service:: Test Plan

API Version:: 7.1-preview.2

複製測試計劃

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

With optional parameters:

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

URI 參數

名稱	位於	必要	類型	Description
organization	path	True	string	Azure DevOps 組織的名稱。
project	path	True	string	專案識別碼或專案名稱
api-version	query	True	string	要使用的 API 版本。這應該設定為 '7.1-preview.2'，以使用此版本的 API。
deepClone	query		boolean	同時複製所有相關聯的測試案例

要求本文

名稱	類型	Description
cloneOptions	CloneOptions	測試計劃複製建立參數
destinationTestPlan	DestinationTestPlanCloneParams	目的地測試計劃的相關資訊
sourceTestPlan	SourceTestPlanInfo	來源測試計劃的相關資訊

回應

名稱	類型	Description
200 OK	CloneTestPlanOperationInformation	成功作業

安全性

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	授與讀取、建立及更新測試計劃、案例、結果和其他測試管理相關成品的能力。

定義

名稱	Description
BuildDefinitionReference	組建定義參考資源
CloneOperationCommonResponse	複製作業的常見回應
CloneOperationState	複製作業狀態
CloneOptions	複製測試套件的複製選項。
CloneStatistics	複製統計資料詳細資料。
CloneTestPlanOperationInformation	測試計劃複製作業的回應
CloneTestPlanParams	測試計劃複製作業的參數
DestinationTestPlanCloneParams	目的地測試計劃建立參數
IdentityRef
ProjectState	專案狀態。
ProjectVisibility	專案可見度。
ReferenceLinks	表示 REST 參考連結集合的類別。
ReleaseEnvironmentDefinitionReference	發行環境資源的參考。
SourceTestPlanInfo	測試計劃複製作業的來源測試計劃資訊
SourceTestplanResponse	測試計劃複製作業的來源測試計劃回應
TeamProjectReference	表示 TeamProject 的淺層參考。
TestOutcomeSettings	測試結果設定
TestPlan	測試計劃資源。
TestSuiteReference	測試套件參考資源。

BuildDefinitionReference

組建定義參考資源

名稱	類型	Description
id	integer	組建定義的識別碼
name	string	組建定義的名稱

CloneOperationCommonResponse

複製作業的常見回應

名稱	類型	Description
cloneStatistics	CloneStatistics	與複製作業相關的各種統計資料
completionDate	string	作業的完成資料
creationDate	string	作業的建立資料
links	ReferenceLinks	參考連結
message	string	與作業相關的訊息
opId	integer	複製作業識別碼
state	CloneOperationState	複製作業狀態

CloneOperationState

複製作業狀態

名稱	類型	Description
failed	string	失敗狀態的值
inProgress	string	輸入狀態的值
queued	string	佇列狀態的值
succeeded	string	成功狀態的值

CloneOptions

複製測試套件的複製選項。

名稱	類型	Description
cloneRequirements	boolean	如果設定為 true 需求，將會複製
copyAllSuites	boolean	從來源方案複製所有套件
copyAncestorHierarchy	boolean	複製上階階層
destinationWorkItemType	string	複製的工作專案類型名稱
overrideParameters	object	索引鍵值組，其中索引鍵值會由值覆寫。
relatedLinkComment	string	將新複製測試案例連結至原始 Set null 的連結批註，以無批註顯示

CloneStatistics

複製統計資料詳細資料。

名稱	類型	Description
clonedRequirementsCount	integer	到目前為止複製的需求數目。
clonedSharedStepsCount	integer	到目前為止複製的共用步驟數目。
clonedTestCasesCount	integer	到目前為止複製的測試案例數目
totalRequirementsCount	integer	要複製的需求總數
totalTestCasesCount	integer	要複製的測試案例總數

CloneTestPlanOperationInformation

測試計劃複製作業的回應

名稱	類型	Description
cloneOperationResponse	CloneOperationCommonResponse	與複製相關的各種資訊
cloneOptions	CloneOptions	測試計劃複製建立參數
destinationTestPlan	TestPlan	目的地測試計劃的資訊
sourceTestPlan	SourceTestplanResponse	來源測試計劃的資訊

CloneTestPlanParams

測試計劃複製作業的參數

名稱	類型	Description
cloneOptions	CloneOptions	測試計劃複製建立參數
destinationTestPlan	DestinationTestPlanCloneParams	目的地測試計劃的相關資訊
sourceTestPlan	SourceTestPlanInfo	來源測試計劃的相關資訊

DestinationTestPlanCloneParams

目的地測試計劃建立參數

名稱	類型	Description
areaPath	string	測試計劃的區域。
buildDefinition	BuildDefinitionReference	產生與此測試計劃相關聯之組建的組建定義。
buildId	integer	要測試的組建。
description	string	測試計劃的描述。
endDate	string	測試計劃的結束日期。
iteration	string	測試計劃的反復專案路徑。
name	string	測試計劃的名稱。
owner	IdentityRef	測試計劃的擁有者。
project	string	目的地專案名稱
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	用來從此測試計劃部署及執行自動化測試的發行環境。
startDate	string	測試計劃的開始日期。
state	string	測試計劃的狀態。
testOutcomeSettings	TestOutcomeSettings	設定測試計劃下測試套件之間相同測試的行為值

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 是此圖表主體來源資源的完整路由。

ProjectState

專案狀態。

名稱	類型	Description
all	string	所有專案，不論刪除以外的狀態為何。
createPending	string	專案已排入佇列以建立，但程式尚未啟動。
deleted	string	專案已刪除。
deleting	string	Project 正在刪除。
new	string	Project 正在建立中。
unchanged	string	專案尚未變更。
wellFormed	string	Project 已完全建立並可供使用。

ProjectVisibility

專案可見度。

名稱	類型	Description
private	string	只有具有明確存取權的使用者才能看到專案。
public	string	專案對全部可見。

ReferenceLinks

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

名稱	類型	Description
links	object	連結的唯讀檢視。因為參考連結是唯讀的，所以我們只想要將它們公開為唯讀。

ReleaseEnvironmentDefinitionReference

發行環境資源的參考。

名稱	類型	Description
definitionId	integer	包含發行環境定義的發行定義識別碼。
environmentDefinitionId	integer	發行環境定義的識別碼。

SourceTestPlanInfo

測試計劃複製作業的來源測試計劃資訊

名稱	類型	Description
id	integer	來源測試計劃的識別碼
suiteIds	integer[]	要複製到來源測試計劃內的套件識別碼

SourceTestplanResponse

測試計劃複製作業的來源測試計劃回應

名稱	類型	Description
id	integer	測試計劃的識別碼。
name	string	測試計劃的名稱。
project	TeamProjectReference	專案參考
suiteIds	integer[]	要複製到來源測試計劃內的套件識別碼

TeamProjectReference

表示 TeamProject 的淺層參考。

名稱	類型	Description
abbreviation	string	專案縮寫。
defaultTeamImageUrl	string	預設小組身分識別影像的 URL。
description	string	如果有任何) ，專案的描述 (。
id	string	專案識別碼。
lastUpdateTime	string	專案上次更新時間。
name	string	專案名稱。
revision	integer	專案修訂。
state	ProjectState	專案狀態。
url	string	物件完整版本的 URL。
visibility	ProjectVisibility	專案可見度。

TestOutcomeSettings

測試結果設定

名稱	類型	Description
syncOutcomeAcrossSuites	boolean	設定如何在套件間顯示相同測試測試結果的值

TestPlan

測試計劃資源。

名稱	類型	Description
_links	ReferenceLinks	相關連結
areaPath	string	測試計劃的區域。
buildDefinition	BuildDefinitionReference	產生與此測試計劃相關聯之組建的組建定義。
buildId	integer	要測試的組建。
description	string	測試計劃的描述。
endDate	string	測試計劃的結束日期。
id	integer	測試計劃的識別碼。
iteration	string	測試計劃的反復專案路徑。
name	string	測試計劃的名稱。
owner	IdentityRef	測試計劃的擁有者。
previousBuildId	integer	與測試計劃相關聯的先前組建識別碼
project	TeamProjectReference	包含測試計劃的專案。
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	用來從此測試計劃部署及執行自動化測試的發行環境。
revision	integer	測試計劃的修訂。
rootSuite	TestSuiteReference	測試計劃的根測試套件。
startDate	string	測試計劃的開始日期。
state	string	測試計劃的狀態。
testOutcomeSettings	TestOutcomeSettings	設定測試計劃下測試套件之間相同測試的行為值
updatedBy	IdentityRef	測試計劃上次更新的身分識別參考
updatedDate	string	測試計劃的更新日期

TestSuiteReference

測試套件參考資源。

名稱	類型	Description
id	integer	測試套件的識別碼。
name	string	測試套件的名稱。

共用方式為