Test Plan Clone - Clone Test Plan

Service:

Test Plan

API Version:

7.1-preview.2

Clonare il piano di test

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path	True	string	ID progetto o nome del progetto
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1-preview.2' per usare questa versione dell'API.
deepClone	query		boolean	Clona anche tutti i test case associati

Corpo della richiesta

Nome	Tipo	Descrizione
cloneOptions	CloneOptions	Parametri di creazione del piano di test clone
destinationTestPlan	DestinationTestPlanCloneParams	Informazioni sul piano di test di destinazione
sourceTestPlan	SourceTestPlanInfo	Informazioni sul piano di test di origine

Risposte

Nome	Tipo	Descrizione
200 OK	CloneTestPlanOperationInformation	operazione riuscita

Sicurezza

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

Nome	Descrizione
vso.test_write	Concede la possibilità di leggere, creare e aggiornare piani di test, case, risultati e altri artefatti correlati alla gestione dei test.

Definizioni

Nome	Descrizione
BuildDefinitionReference	Risorsa di riferimento per la definizione di compilazione
CloneOperationCommonResponse	Risposta comune per l'operazione di clonazione
CloneOperationState	Clonare lo stato dell'operazione
CloneOptions	Opzioni di clonazione per la clonazione del gruppo di test.
CloneStatistics	Clonare i dettagli delle statistiche.
CloneTestPlanOperationInformation	Risposta per l'operazione di clonazione del piano di test
CloneTestPlanParams	Parametri per l'operazione di clonazione del piano di test
DestinationTestPlanCloneParams	Parametri di creazione del piano di test di destinazione
IdentityRef
ProjectState	Stato del progetto.
ProjectVisibility	Visibilità del progetto.
ReferenceLinks	Classe per rappresentare una raccolta di collegamenti di riferimento REST.
ReleaseEnvironmentDefinitionReference	Riferimento alla risorsa dell'ambiente di rilascio.
SourceTestPlanInfo	Informazioni sul piano di test di origine per l'operazione di clonazione del piano di test
SourceTestplanResponse	Risposta del piano di test di origine per l'operazione di clonazione del piano di test
TeamProjectReference	Rappresenta un riferimento superficiale a un oggetto TeamProject.
TestOutcomeSettings	Impostazioni dei risultati dei test
TestPlan	Risorsa del piano di test.
TestSuiteReference	Risorsa di riferimento del gruppo di test.

BuildDefinitionReference

Risorsa di riferimento per la definizione di compilazione

Nome	Tipo	Descrizione
id	integer	ID della definizione di compilazione
name	string	Nome della definizione di compilazione

CloneOperationCommonResponse

Risposta comune per l'operazione di clonazione

Nome	Tipo	Descrizione
cloneStatistics	CloneStatistics	Varie statistiche correlate all'operazione di clonazione
completionDate	string	Dati di completamento dell'operazione
creationDate	string	Dati di creazione dell'operazione
links	ReferenceLinks	Collegamenti a informazioni di riferimento
message	string	Messaggio correlato al processo
opId	integer	ID operazione di clonazione
state	CloneOperationState	Clonare lo stato dell'operazione

CloneOperationState

Clonare lo stato dell'operazione

Nome	Tipo	Descrizione
failed	string	valore per stato non riuscito
inProgress	string	value per stato Inprogress
queued	string	Valore per lo stato in coda
succeeded	string	valore per stato Operazione riuscita

CloneOptions

Opzioni di clonazione per la clonazione del gruppo di test.

Nome	Tipo	Descrizione
cloneRequirements	boolean	Se è impostato su true, i requisiti verranno clonati
copyAllSuites	boolean	copiare tutte le suite da un piano di origine
copyAncestorHierarchy	boolean	copiare la gerarchia predecessore
destinationWorkItemType	string	Nome del tipo di elemento di lavoro del clone
overrideParameters	object	Coppie chiave-valore in cui il valore della chiave viene sottoposto a override dal valore .
relatedLinkComment	string	Commento sul collegamento che collega il nuovo test case clone al set originale Null per nessun commento

CloneStatistics

Clonare i dettagli delle statistiche.

Nome	Tipo	Descrizione
clonedRequirementsCount	integer	Numero di requisiti clonati finora.
clonedSharedStepsCount	integer	Numero di passaggi condivisi clonati finora.
clonedTestCasesCount	integer	Numero di test case clonati finora
totalRequirementsCount	integer	Numero totale di requisiti da clonare
totalTestCasesCount	integer	Numero totale di test case da clonare

CloneTestPlanOperationInformation

Risposta per l'operazione di clonazione del piano di test

Nome	Tipo	Descrizione
cloneOperationResponse	CloneOperationCommonResponse	Varie informazioni correlate al clone
cloneOptions	CloneOptions	Parametri di creazione del piano di test clone
destinationTestPlan	TestPlan	Informazioni sul piano di test di destinazione
sourceTestPlan	SourceTestplanResponse	Informazioni sul piano di test di origine

CloneTestPlanParams

Parametri per l'operazione di clonazione del piano di test

Nome	Tipo	Descrizione
cloneOptions	CloneOptions	Parametri di creazione del piano di test clone
destinationTestPlan	DestinationTestPlanCloneParams	Informazioni sul piano di test di destinazione
sourceTestPlan	SourceTestPlanInfo	Informazioni sul piano di test di origine

DestinationTestPlanCloneParams

Parametri di creazione del piano di test di destinazione

Nome	Tipo	Descrizione
areaPath	string	Area del piano di test.
buildDefinition	BuildDefinitionReference	Definizione di compilazione che genera una compilazione associata a questo piano di test.
buildId	integer	Compilazione da testare.
description	string	Descrizione del piano di test.
endDate	string	Data di fine per il piano di test.
iteration	string	Percorso di iterazione del piano di test.
name	string	Nome del piano di test.
owner	IdentityRef	Proprietario del piano di test.
project	string	Nome progetto di destinazione
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Ambiente di rilascio da usare per distribuire la compilazione ed eseguire test automatizzati da questo piano di test.
startDate	string	Data di inizio per il piano di test.
state	string	Stato del piano di test.
testOutcomeSettings	TestOutcomeSettings	Valore per configurare il comportamento degli stessi test tra gruppi di test in un piano di test

IdentityRef

Nome	Tipo	Descrizione
_links	ReferenceLinks	Questo campo contiene zero o più collegamenti interessanti sull'oggetto del grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate su questo oggetto grafico.
descriptor	string	Il descrittore è il modo principale per fare riferimento all'oggetto del grafo mentre il sistema è in esecuzione. Questo campo identificherà in modo univoco lo stesso oggetto grafico in account e organizzazioni.
directoryAlias	string	Deprecato: può essere recuperato eseguendo una query sull'utente graph a cui si fa riferimento nella voce "self" del dizionario "_links" IdentityRef
displayName	string	Si tratta del nome visualizzato non univoco dell'oggetto del grafico. Per modificare questo campo, è necessario modificarne il valore nel provider di origine.
id	string
imageUrl	string	Deprecato : disponibile nella voce "avatar" del dizionario IdentityRef "_links"
inactive	boolean	Deprecato: può essere recuperato eseguendo una query sullo stato di appartenenza graph a cui si fa riferimento nella voce "membershipState" del dizionario GraphUser "_links"
isAadIdentity	boolean	Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Deprecato: non in uso nella maggior parte delle implementazioni preesistenti di ToIdentityRef
uniqueName	string	Deprecato: usare invece Domain+PrincipalName
url	string	Questo URL è la route completa alla risorsa di origine di questo oggetto grafico.

ProjectState

Stato del progetto.

Nome	Tipo	Descrizione
all	string	Tutti i progetti indipendentemente dallo stato ad eccezione di Deleted.
createPending	string	Il progetto è stato accodato per la creazione, ma il processo non è ancora stato avviato.
deleted	string	Il progetto è stato eliminato.
deleting	string	Il progetto è in fase di eliminazione.
new	string	Il progetto è in fase di creazione.
unchanged	string	Il progetto non è stato modificato.
wellFormed	string	Il progetto è completamente creato e pronto per l'uso.

ProjectVisibility

Visibilità del progetto.

Nome	Tipo	Descrizione
private	string	Il progetto è visibile solo agli utenti con accesso esplicito.
public	string	Il progetto è visibile a tutti.

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

ReleaseEnvironmentDefinitionReference

Riferimento alla risorsa dell'ambiente di rilascio.

Nome	Tipo	Descrizione
definitionId	integer	ID della definizione di versione che contiene la definizione dell'ambiente di versione.
environmentDefinitionId	integer	ID della definizione dell'ambiente di versione.

SourceTestPlanInfo

Informazioni sul piano di test di origine per l'operazione di clonazione del piano di test

Nome	Tipo	Descrizione
id	integer	ID del piano di test di origine
suiteIds	integer[]	ID dei gruppi da clonare all'interno del piano di test di origine

SourceTestplanResponse

Risposta del piano di test di origine per l'operazione di clonazione del piano di test

Nome	Tipo	Descrizione
id	integer	ID del piano di test.
name	string	Nome del piano di test.
project	TeamProjectReference	riferimento al progetto
suiteIds	integer[]	ID dei gruppi da clonare all'interno del piano di test di origine

TeamProjectReference

Rappresenta un riferimento superficiale a un oggetto TeamProject.

Nome	Tipo	Descrizione
abbreviation	string	Abbreviazione del progetto.
defaultTeamImageUrl	string	URL dell'immagine di identità del team predefinita.
description	string	Descrizione del progetto (se presente).
id	string	Identificatore del progetto.
lastUpdateTime	string	Ora dell'ultimo aggiornamento del progetto.
name	string	Nome progetto.
revision	integer	Revisione del progetto.
state	ProjectState	Stato del progetto.
url	string	URL della versione completa dell'oggetto.
visibility	ProjectVisibility	Visibilità del progetto.

TestOutcomeSettings

Impostazioni dei risultati dei test

Nome	Tipo	Descrizione
syncOutcomeAcrossSuites	boolean	Valore per configurare la modalità di visualizzazione dei risultati dei test per gli stessi test tra gruppi

TestPlan

Risorsa del piano di test.

Nome	Tipo	Descrizione
_links	ReferenceLinks	Collegamenti pertinenti
areaPath	string	Area del piano di test.
buildDefinition	BuildDefinitionReference	Definizione di compilazione che genera una compilazione associata a questo piano di test.
buildId	integer	Compilazione da testare.
description	string	Descrizione del piano di test.
endDate	string	Data di fine per il piano di test.
id	integer	ID del piano di test.
iteration	string	Percorso di iterazione del piano di test.
name	string	Nome del piano di test.
owner	IdentityRef	Proprietario del piano di test.
previousBuildId	integer	ID build precedente associato al piano di test
project	TeamProjectReference	Progetto che contiene il piano di test.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Ambiente di rilascio da usare per distribuire la compilazione ed eseguire test automatizzati da questo piano di test.
revision	integer	Revisione del piano di test.
rootSuite	TestSuiteReference	Gruppo di test radice del piano di test.
startDate	string	Data di inizio per il piano di test.
state	string	Stato del piano di test.
testOutcomeSettings	TestOutcomeSettings	Valore per configurare il comportamento degli stessi test tra gruppi di test in un piano di test
updatedBy	IdentityRef	Riferimento all'identità per l'ultimo aggiornamento del piano di test
updatedDate	string	Data aggiornata del piano di test

TestSuiteReference

Risorsa di riferimento del gruppo di test.

Nome	Tipo	Descrizione
id	integer	ID del gruppo di test.
name	string	Nome del gruppo di test.