Partilhar via

Clone Operation - Clone Test Suite

  • Referência
Serviço:
Test
Versão da API:
5.0-preview.2

Clonar conjunto de testes

POST https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/Suites/{sourceSuiteId}/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 no qual o pacote a ser clonado está presente
project
 path True

string

ID do projeto ou nome do projeto
sourceSuiteId
 path True

integer

int32

ID do conjunto de testes a ser clonado
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
cloneOptions

CloneOptions

Opções de clonagem para clonar o conjunto de testes.
destinationSuiteId

integer

ID do pacote sob o qual precisamos clonar o pacote.
destinationSuiteProjectName

string

Nome do projeto do pacote de destino.

Respostas

Nome Tipo Description
200 OK

CloneOperationInformation

operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do Token: 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

Escopos

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

Solicitação de exemplo

POST https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/{sourceSuiteId}/cloneoperation?api-version=5.0-preview.2

{
  "destinationSuiteId": 13,
  "destinationSuiteProjectName": "fabrikam-fiber-tfvc2",
  "cloneOptions": {
    "copyAncestorHierarchy": true,
    "overrideParameters": {
      "System.AreaPath": "fabrikam-fiber-tfvc2",
      "System.IterationPath": "fabrikam-fiber-tfvc2"
    }
  }
}

Resposta de exemplo

Código de status:
200 
{
  "opId": 3,
  "creationDate": "0001-01-01T00:00:00",
  "completionDate": "0001-01-01T00:00:00",
  "state": "queued",
  "message": null,
  "cloneStatistics": null,
  "resultObjectType": "testSuite",
  "destinationObject": {
    "id": "14",
    "name": "simpleCloned",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc2/_apis/test/Plans/13/Suites/14"
  },
  "sourceObject": {
    "id": "1",
    "name": "TestSuite1",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/2"
  },
  "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/3"
}

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
ResultObjectType

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

Uma referência abstrata 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.
TestSuiteCloneRequest

Solicitação de clone do conjunto de testes

CloneOperationInformation

Object

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

Enumeration

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

Valor Description
failed

valor de Estado com Falha
inProgress

value for Inprogress state
queued

Valor do estado enfileirado
succeeded

value para o estado de êxito

CloneOptions

Object
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 Set null original para nenhum comentário

CloneStatistics

Object
Nome Tipo Description
clonedRequirementsCount

integer

Número de requerimentos clonados até agora.
clonedSharedStepsCount

integer

Número de etapas compartilhadas clonadas até agora.
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

ResultObjectType

Enumeration

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

Valor Description
testPlan

Clone de Plano
testSuite

Clone do pacote

ShallowReference

Object

Uma referência abstrata 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

TestSuiteCloneRequest

Object

Solicitação de clone do conjunto de testes

Nome Tipo Description
cloneOptions

CloneOptions

Opções de clonagem para clonar o conjunto de testes.
destinationSuiteId

integer

ID do pacote sob o qual precisamos clonar o pacote.
destinationSuiteProjectName

string

Nome do projeto do pacote de destino.