Clone Operation - Clone Test Plan

Referencia

Service:: Test

API Version:: 5.0-preview.2

Clonar plan de prueba

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El nombre de la organización de Azure DevOps.
planId	path	True	integer int32	Identificador del plan de prueba que se va a clonar.
project	path	True	string	Id. de proyecto o nombre del proyecto
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "5.0-preview.2" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre	Tipo	Description
destinationTestPlan	TestPlan	Recurso del plan de prueba.
options	CloneOptions
suiteIds	integer[]

Respuestas

Nombre	Tipo	Description
200 OK	CloneOperationInformation	operación correcta

Seguridad

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

Nombre	Description
vso.test_write	Concede la capacidad de leer, crear y actualizar planes de prueba, casos, resultados y otros artefactos relacionados con la administración de pruebas.

Ejemplos

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

Definiciones

Nombre	Description
CloneOperationInformation	Detalles sobre la operación de clonación.
CloneOperationState	Estado actual de la operación. Cuando el estado llega a Suceeded o Failed, la operación se completa.
CloneOptions
CloneStatistics
IdentityRef
ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.
ReleaseEnvironmentDefinitionReference	Referencia al recurso del entorno de versión.
ResultObjectType	Tipo del objeto generado como resultado de la operación Clonar
ShallowReference	Referencia abstracta a algún otro recurso. Esta clase se usa para proporcionar los contratos de datos de compilación con una manera uniforme de hacer referencia a otros recursos de una manera que proporciona un recorrido fácil a través de vínculos.
TestOutcomeSettings	Configuración del resultado de la prueba
TestPlan	Recurso del plan de prueba.
TestPlanCloneRequest

CloneOperationInformation

Detalles sobre la operación de clonación.

Nombre	Tipo	Description
cloneStatistics	CloneStatistics	Clonar estadísticas
completionDate	string	Si se completa la operación, datetime de finalización. Si la operación no está completa, se trata de DateTime.MaxValue.
creationDate	string	DateTime cuando se inició la operación
destinationObject	ShallowReference	Referencia superficial del destino
destinationPlan	ShallowReference	Referencia superficial del destino
destinationProject	ShallowReference	Referencia superficial del destino
message	string	Si la operación tiene error, Message contiene el motivo del error. De lo contrario, es NULL.
opId	integer	Identificador de la operación
resultObjectType	ResultObjectType	Tipo del objeto generado como resultado de la operación Clonar
sourceObject	ShallowReference	Referencia superficial del origen
sourcePlan	ShallowReference	Referencia superficial del origen
sourceProject	ShallowReference	Referencia superficial del origen
state	CloneOperationState	Estado actual de la operación. Cuando el estado llega a Suceeded o Failed, la operación se completa.
url	string	Dirección URL para obtener la información de clonación

CloneOperationState

Estado actual de la operación. Cuando el estado llega a Suceeded o Failed, la operación se completa.

Nombre	Tipo	Description
failed	string	valor de Estado erróneo
inProgress	string	valor para el estado de inprogress
queued	string	Valor para estado en cola
succeeded	string	valor del estado Correcto

CloneOptions

Nombre	Tipo	Description
cloneRequirements	boolean	Si se establece en true requirements se clonará.
copyAllSuites	boolean	copiar todos los conjuntos desde un plan de origen
copyAncestorHierarchy	boolean	copiar antecesor hieracrchy
destinationWorkItemType	string	Nombre del tipo workitem del clon
overrideParameters	object	Pares clave-valor donde el valor de clave se invalida por el valor.
relatedLinkComment	string	Comentario en el vínculo que vinculará el nuevo caso de prueba de clonación al valor null set original para ningún comentario

CloneStatistics

Nombre	Tipo	Description
clonedRequirementsCount	integer	Número de solicitudes clonadas hasta ahora.
clonedSharedStepsCount	integer	Número de pasos compartidos clonados hasta ahora.
clonedTestCasesCount	integer	Número de casos de prueba clonados hasta ahora
totalRequirementsCount	integer	Número total de requisitos que se van a clonar
totalTestCasesCount	integer	Número total de casos de prueba que se van a clonar

IdentityRef

Nombre	Tipo	Description
_links	ReferenceLinks	Este campo contiene cero o más vínculos interesantes sobre el tema del grafo. Estos vínculos se pueden invocar para obtener relaciones adicionales o información más detallada sobre este tema del grafo.
descriptor	string	El descriptor es la forma principal de hacer referencia al asunto del grafo mientras se ejecuta el sistema. Este campo identificará de forma única el mismo asunto del grafo en cuentas y organizaciones.
directoryAlias	string
displayName	string	Este es el nombre para mostrar no único del asunto del grafo. Para cambiar este campo, debe modificar su valor en el proveedor de origen.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo.

ReferenceLinks

Clase que se va a representar una colección de vínculos de referencia de REST.

Nombre	Tipo	Description
links	object	Vista de lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

ReleaseEnvironmentDefinitionReference

Referencia al recurso del entorno de versión.

Nombre	Tipo	Description
definitionId	integer	Identificador de la definición de versión que contiene la definición del entorno de versión.
environmentDefinitionId	integer	Identificador de la definición del entorno de versión.

ResultObjectType

Tipo del objeto generado como resultado de la operación Clonar

Nombre	Tipo	Description
testPlan	string	Clonación del plan
testSuite	string	Clonación de conjunto de aplicaciones

ShallowReference

Referencia abstracta a algún otro recurso. Esta clase se usa para proporcionar los contratos de datos de compilación con una manera uniforme de hacer referencia a otros recursos de una manera que proporciona un recorrido fácil a través de vínculos.

Nombre	Tipo	Description
id	string	Identificador del recurso
name	string	Nombre del recurso vinculado (nombre de definición, nombre del controlador, etc.)
url	string	Vínculo http completo al recurso

TestOutcomeSettings

Configuración del resultado de la prueba

Nombre	Tipo	Description
syncOutcomeAcrossSuites	boolean	Valor para configurar cómo se muestran los resultados de las pruebas de las mismas pruebas entre conjuntos

TestPlan

Recurso del plan de prueba.

Nombre	Tipo	Description
area	ShallowReference	Área del plan de pruebas.
build	ShallowReference	Compilación que se va a probar.
buildDefinition	ShallowReference	Definición de compilación que genera una compilación asociada a este plan de prueba.
description	string	Descripción del plan de prueba.
endDate	string	Fecha de finalización del plan de prueba.
id	integer	Identificador del plan de prueba.
iteration	string	Ruta de acceso de iteración del plan de prueba.
name	string	Nombre del plan de prueba.
owner	IdentityRef	Propietario del plan de prueba.
previousBuild	ShallowReference	Referencia abstracta a algún otro recurso. Esta clase se usa para proporcionar los contratos de datos de compilación con una manera uniforme de hacer referencia a otros recursos de una manera que proporciona un recorrido fácil a través de vínculos.
project	ShallowReference	Proyecto que contiene el plan de prueba.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Entorno de versión que se usará para implementar la compilación y ejecutar pruebas automatizadas a partir de este plan de prueba.
revision	integer	Revisión del plan de prueba.
rootSuite	ShallowReference	Conjunto de pruebas raíz del plan de pruebas.
startDate	string	Fecha de inicio del plan de prueba.
state	string	Estado del plan de prueba.
testOutcomeSettings	TestOutcomeSettings	Valor para configurar cómo deben comportarse las mismas pruebas en conjuntos de pruebas en un plan de pruebas
updatedBy	IdentityRef
updatedDate	string
url	string	Dirección URL del recurso del plan de prueba.

TestPlanCloneRequest

Nombre	Tipo	Description
destinationTestPlan	TestPlan	Recurso del plan de prueba.
options	CloneOptions
suiteIds	integer[]

Compartir a través de