Clone Operation - Clone Test Plan

Référence

Service:: Test

API Version:: 5.0-preview.2

Cloner le plan de test

POST https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/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 à cloner.
project	path	True	string	ID de projet ou nom du projet
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
destinationTestPlan	TestPlan	Ressource de plan de test.
options	CloneOptions
suiteIds	integer[]

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	Permet de lire, de créer et de 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/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"
}

Définitions

Nom	Description
CloneOperationInformation	Détails sur l’opération de clonage.
CloneOperationState	État actuel de l’opération. Lorsque l’état atteint Suceededed ou Failed, l’opération est terminée
CloneOptions
CloneStatistics
IdentityRef
ReferenceLinks	Classe pour représenter une collection de liens de référence REST.
ReleaseEnvironmentDefinitionReference	Référence à la ressource d’environnement de mise en production.
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 d’une manière qui permet de parcourir facilement les liens.
TestOutcomeSettings	Paramètres des résultats du test
TestPlan	Ressource de plan de test.
TestPlanCloneRequest

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 Suceededed ou Failed, l’opération est terminée
url	string	URL pour obtenir les informations de clone

CloneOperationState

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

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

CloneOptions

Nom	Type	Description
cloneRequirements	boolean	Si la valeur est true, les exigences seront clonées
copyAllSuites	boolean	copier toutes les suites à partir d’un plan source
copyAncestorHierarchy	boolean	copier la hiérarchie des ancêtres
destinationWorkItemType	string	Nom du type workitem du clone
overrideParameters	object	Paires de valeurs de clé où la valeur de clé est remplacée par la valeur.
relatedLinkComment	string	Commentaire sur le lien qui liera le nouveau cas de test de clone au jeu d’origine null pour aucun commentaire

CloneStatistics

Nom	Type	Description
clonedRequirementsCount	integer	Nombre de réquirments cloné 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

IdentityRef

Nom	Type	Description
_links	ReferenceLinks	Ce champ contient zéro ou plus de liens intéressants sur le sujet du graphe. Ces liens peuvent être appelés pour obtenir des relations supplémentaires ou des informations plus détaillées sur ce sujet de graphique.
descriptor	string	Le descripteur est le principal moyen de référencer l’objet du graphe pendant l’exécution du système. Ce champ identifie de manière unique le même sujet de graphe pour les comptes et les organisations.
directoryAlias	string
displayName	string	Il s’agit du nom d’affichage non unique du sujet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphique.

ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

ReleaseEnvironmentDefinitionReference

Référence à la ressource d’environnement de mise en production.

Nom	Type	Description
definitionId	integer	ID de la définition de mise en production qui contient la définition d’environnement de mise en production.
environmentDefinitionId	integer	ID de la définition de l’environnement de mise en production.

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 d’une manière qui permet de parcourir facilement les 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

TestOutcomeSettings

Paramètres des résultats du test

Nom	Type	Description
syncOutcomeAcrossSuites	boolean	Valeur pour configurer la façon dont les résultats des tests pour les mêmes tests entre les suites sont affichés

TestPlan

Ressource de plan de test.

Nom	Type	Description
area	ShallowReference	Zone du plan de test.
build	ShallowReference	Build à tester.
buildDefinition	ShallowReference	Définition de build qui génère une build associée à ce plan de test.
description	string	Description du plan de test.
endDate	string	Date de fin du plan de test.
id	integer	ID du plan de test.
iteration	string	Chemin d’itération du plan de test.
name	string	Nom du plan de test.
owner	IdentityRef	Propriétaire du plan de test.
previousBuild	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 d’une manière qui permet de parcourir facilement les liens.
project	ShallowReference	Projet qui contient le plan de test.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Release Environment à utiliser pour déployer la génération et exécuter des tests automatisés à partir de ce plan de test.
revision	integer	Révision du plan de test.
rootSuite	ShallowReference	Suite de tests racine du plan de test.
startDate	string	Date de début du plan de test.
state	string	État du plan de test.
testOutcomeSettings	TestOutcomeSettings	Valeur pour configurer le comportement des mêmes tests entre les suites de tests dans le cadre d’un plan de test
updatedBy	IdentityRef
updatedDate	string
url	string	URL de la ressource de plan de test.

TestPlanCloneRequest

Nom	Type	Description
destinationTestPlan	TestPlan	Ressource de plan de test.
options	CloneOptions
suiteIds	integer[]

Partager via