Partager via

Clone Operation - Clone Test Suite

  • Référence
Service:
Test
Version d'API:
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
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

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

Exemple de requête

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

Exemple de réponse

Code d’état:
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

Object

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

Enumeration

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

Valeur Description
failed

valeur de l’état d’échec
inProgress

valeur de l’état Inprogress
queued

Valeur de l’état mis en file d’attente
succeeded

valeur pour État de réussite

CloneOptions

Object
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

Object
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

Enumeration

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

Valeur Description
testPlan

Cloner le plan
testSuite

Suite Clone

ShallowReference

Object

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

Object

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.