Clone Operation - Clone Test Plan

Referência

Service:: Test

API Version:: 5.0-preview.2

Clonar plano de teste

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
planId	path	True	integer int32	ID do plano de teste a ser clonado.
project	path	True	string	ID do projeto ou nome do projeto
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '5.0-preview.2' para usar essa versão da api.

Corpo da solicitação

Nome	Tipo	Description
destinationTestPlan	TestPlan	O recurso de plano de teste.
options	CloneOptions
suiteIds	integer[]

Respostas

Nome	Tipo	Description
200 OK	CloneOperationInformation	operação bem-sucedida

Segurança

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	Description
vso.test_write	Concede a capacidade de ler, criar e atualizar planos de teste, casos, resultados e outros artefatos relacionados ao gerenciamento de testes.

Exemplos

Sample Request

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
  ]
}

Sample Response

Status code:: 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"
}

Definições

Nome	Description
CloneOperationInformation	Detalhes sobre a operação de clonagem.
CloneOperationState	Estado atual da operação. Quando State atinge Suceeded ou Failed, a operação é concluída
CloneOptions
CloneStatistics
IdentityRef
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
ReleaseEnvironmentDefinitionReference	Referência ao recurso de ambiente de lançamento.
ResultObjectType	O tipo do objeto gerado como resultado da operação Clonar
ShallowReference	Uma referência abstraida a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.
TestOutcomeSettings	Configurações de resultado de teste
TestPlan	O recurso de plano de teste.
TestPlanCloneRequest

CloneOperationInformation

Detalhes sobre a operação de clonagem.

Nome	Tipo	Description
cloneStatistics	CloneStatistics	Clonar Estatísticas
completionDate	string	Se a operação for concluída, o DateTime da conclusão. Se a operação não estiver concluída, este será DateTime.MaxValue
creationDate	string	DateTime quando a operação foi iniciada
destinationObject	ShallowReference	Referência superficial do destino
destinationPlan	ShallowReference	Referência superficial do destino
destinationProject	ShallowReference	Referência superficial do destino
message	string	Se a operação tiver falhado, Message conterá o motivo da falha. Do contrário, nulo.
opId	integer	A ID da operação
resultObjectType	ResultObjectType	O tipo do objeto gerado como resultado da operação Clonar
sourceObject	ShallowReference	Referência superficial da origem
sourcePlan	ShallowReference	Referência superficial da origem
sourceProject	ShallowReference	Referência superficial da origem
state	CloneOperationState	Estado atual da operação. Quando State atinge Suceeded ou Failed, a operação é concluída
url	string	URL para obter as informações de clone

CloneOperationState

Estado atual da operação. Quando State atinge Suceeded ou Failed, a operação é concluída

Nome	Tipo	Description
failed	string	valor de Estado com Falha
inProgress	string	value for Inprogress state
queued	string	Valor do estado enfileirado
succeeded	string	valor para o estado Êxito

CloneOptions

Nome	Tipo	Description
cloneRequirements	boolean	Se definido como requisitos verdadeiros será clonado
copyAllSuites	boolean	copiar todos os pacotes de um plano de origem
copyAncestorHierarchy	boolean	copiar hieracrchy ancestral
destinationWorkItemType	string	Nome do tipo workitem do clone
overrideParameters	object	Pares de valor de chave em que o valor da chave é substituído pelo valor .
relatedLinkComment	string	Comente no link que vinculará o novo caso de teste de clone ao conjunto nulo original para nenhum comentário

CloneStatistics

Nome	Tipo	Description
clonedRequirementsCount	integer	Número de Requerimentos clonados até agora.
clonedSharedStepsCount	integer	Número de etapas compartilhadas clonadas até o momento.
clonedTestCasesCount	integer	Número de casos de teste clonados até agora
totalRequirementsCount	integer	Número total de requisitos a serem clonados
totalTestCasesCount	integer	Número total de casos de teste a serem clonados

IdentityRef

Nome	Tipo	Description
_links	ReferenceLinks	Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto de grafo entre contas e organizações.
directoryAlias	string
displayName	string	Esse é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

ReleaseEnvironmentDefinitionReference

Referência ao recurso de ambiente de lançamento.

Nome	Tipo	Description
definitionId	integer	ID da definição de versão que contém a definição do ambiente de versão.
environmentDefinitionId	integer	ID da definição do ambiente de versão.

ResultObjectType

O tipo do objeto gerado como resultado da operação Clonar

Nome	Tipo	Description
testPlan	string	Planejar clonagem
testSuite	string	Clone do Pacote

ShallowReference

Uma referência abstraida a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.

Nome	Tipo	Description
id	string	ID do recurso
name	string	Nome do recurso vinculado (nome da definição, nome do controlador etc.)
url	string	Link http completo para o recurso

TestOutcomeSettings

Configurações de resultado de teste

Nome	Tipo	Description
syncOutcomeAcrossSuites	boolean	Valor para configurar como os resultados de teste para os mesmos testes entre conjuntos são mostrados

TestPlan

O recurso de plano de teste.

Nome	Tipo	Description
area	ShallowReference	Área do plano de teste.
build	ShallowReference	Compilar a ser testado.
buildDefinition	ShallowReference	A Definição de Build que gera um build associado a esse plano de teste.
description	string	Descrição do plano de teste.
endDate	string	Data de término do plano de teste.
id	integer	ID do plano de teste.
iteration	string	Caminho de iteração do plano de teste.
name	string	Nome do plano de teste.
owner	IdentityRef	Proprietário do plano de teste.
previousBuild	ShallowReference	Uma referência abstraida a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.
project	ShallowReference	Projeto que contém o plano de teste.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Release Environment a ser usado para implantar o build e executar testes automatizados a partir deste plano de teste.
revision	integer	Revisão do plano de teste.
rootSuite	ShallowReference	Pacote de teste raiz do plano de teste.
startDate	string	Data de início do plano de teste.
state	string	Estado do plano de teste.
testOutcomeSettings	TestOutcomeSettings	Valor para configurar como os mesmos testes em conjuntos de testes em um plano de teste precisam se comportar
updatedBy	IdentityRef
updatedDate	string
url	string	URL do recurso de plano de teste.

TestPlanCloneRequest

Nome	Tipo	Description
destinationTestPlan	TestPlan	O recurso de plano de teste.
options	CloneOptions
suiteIds	integer[]

Compartilhar via