Clone Operation - Clone Test Suite

Référence

Service:: Test

API Version:: 5.0-preview.2

Cloner la suite de tests

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
planId	path	True	integer int32	ID du plan de test dans lequel la suite à cloner est présente
project	path	True	string	ID de projet ou nom du projet
sourceSuiteId	path	True	integer int32	ID de la suite de tests à cloner
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 5.0-preview.2 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
cloneOptions	CloneOptions	Options de clonage de la suite de tests.
destinationSuiteId	integer	ID de la suite sous lequel nous devons cloner la suite.
destinationSuiteProjectName	string	Nom du projet de la suite de destination.

Réponses

Nom	Type	Description
200 OK	CloneOperationInformation	opération réussie

Sécurité

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

Nom	Description
vso.test_write	Accorde la possibilité de lire, créer et mettre à jour des plans de test, des cas, des résultats et d’autres artefacts liés à la gestion des tests.

Exemples

Sample Request

HTTP

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

Sample Response

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

Définitions

Nom	Description
CloneOperationInformation	Détails sur l’opération de clonage.
CloneOperationState	État actuel de l’opération. Lorsque l’état atteint Suceeded ou Failed, l’opération est terminée
CloneOptions
CloneStatistics
ResultObjectType	Type de l’objet généré à la suite de l’opération Clone
ShallowReference	Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de build un moyen uniforme de référencer d’autres ressources de manière à faciliter la traversée des liens.
TestSuiteCloneRequest	Requête de clonage de la suite de tests

CloneOperationInformation

Détails sur l’opération de clonage.

Nom	Type	Description
cloneStatistics	CloneStatistics	Cloner des statistiques
completionDate	string	Si l’opération est terminée, dateTime de l’achèvement. Si l’opération n’est pas terminée, il s’agit de DateTime.MaxValue
creationDate	string	DateTime au démarrage de l’opération
destinationObject	ShallowReference	Référence superficielle de la destination
destinationPlan	ShallowReference	Référence superficielle de la destination
destinationProject	ShallowReference	Référence superficielle de la destination
message	string	Si l’opération a échoué, message contient la raison de l’échec. Sinon, Null.
opId	integer	ID de l’opération
resultObjectType	ResultObjectType	Type de l’objet généré à la suite de l’opération Clone
sourceObject	ShallowReference	Référence superficielle de la source
sourcePlan	ShallowReference	Référence superficielle de la source
sourceProject	ShallowReference	Référence superficielle de la source
state	CloneOperationState	État actuel de l’opération. Lorsque l’état atteint Suceeded ou Failed, l’opération est terminée
url	string	URL permettant d’obtenir les informations de clonage

CloneOperationState

État actuel de l’opération. Lorsque l’état atteint Suceeded ou Failed, l’opération est terminée

Nom	Type	Description
failed	string	valeur de l’état d’échec
inProgress	string	valeur de l’état Inprogress
queued	string	Valeur de l’état mis en file d’attente
succeeded	string	valeur pour État de réussite

CloneOptions

Nom	Type	Description
cloneRequirements	boolean	Si la valeur est true, la configuration requise est cloné
copyAllSuites	boolean	copier toutes les suites à partir d’un plan source
copyAncestorHierarchy	boolean	copier la hiérarchie ancêtre
destinationWorkItemType	string	Nom du type d’élément de travail du clone
overrideParameters	object	Paires clé-valeur où la valeur de clé est remplacée par la valeur .
relatedLinkComment	string	Commentez le lien qui liera le nouveau cas de test de clone à l’élément Set null d’origine pour aucun commentaire

CloneStatistics

Nom	Type	Description
clonedRequirementsCount	integer	Nombre de requêtes clonées jusqu’à présent.
clonedSharedStepsCount	integer	Nombre d’étapes partagées clonées jusqu’à présent.
clonedTestCasesCount	integer	Nombre de cas de test cloné jusqu’à présent
totalRequirementsCount	integer	Nombre total d’exigences à cloner
totalTestCasesCount	integer	Nombre total de cas de test à cloner

ResultObjectType

Type de l’objet généré à la suite de l’opération Clone

Nom	Type	Description
testPlan	string	Cloner le plan
testSuite	string	Suite Clone

ShallowReference

Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de build un moyen uniforme de référencer d’autres ressources de manière à faciliter la traversée des liens.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource liée (nom de la définition, nom du contrôleur, etc.)
url	string	Lien HTTP complet vers la ressource

TestSuiteCloneRequest

Requête de clonage de la suite de tests

Nom	Type	Description
cloneOptions	CloneOptions	Options de clonage de la suite de tests.
destinationSuiteId	integer	ID de la suite sous lequel nous devons cloner la suite.
destinationSuiteProjectName	string	Nom du projet de la suite de destination.

Partager via