Clone Operation - Clone Test Suite

Referenz

Service:: Test

API Version:: 5.0-preview.2

Klonen der Testsammlung

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
planId	path	True	integer int32	ID des Testplans, in dem die zu klonende Suite vorhanden ist
project	path	True	string	Projekt-ID oder Projektname
sourceSuiteId	path	True	integer int32	ID der zu klonenden Testsammlung
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "5.0-preview.2" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name	Typ	Beschreibung
cloneOptions	CloneOptions	Klonoptionen zum Klonen der Testsammlung.
destinationSuiteId	integer	Suite-ID, unter der wir die Suite klonen müssen.
destinationSuiteProjectName	string	Name des Zielsammlungsprojekts.

Antworten

Name	Typ	Beschreibung
200 OK	CloneOperationInformation	Erfolgreicher Vorgang

Sicherheit

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

Name	Beschreibung
vso.test_write	Ermöglicht das Lesen, Erstellen und Aktualisieren von Testplänen, Fällen, Ergebnissen und anderen Artefakten im Zusammenhang mit der Testverwaltung.

Beispiele

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

Definitionen

Name	Beschreibung
CloneOperationInformation	Details zum Klonvorgang.
CloneOperationState	Aktueller Status des Vorgangs. Wenn Der Status den Status "Erfolgreich" oder "Fehlgeschlagen" erreicht, ist der Vorgang abgeschlossen.
CloneOptions
CloneStatistics
ResultObjectType	Der Typ des Objekts, das als Ergebnis des Klonvorgangs generiert wurde.
ShallowReference	Ein abstrahierter Verweis auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge mit einer einheitlichen Möglichkeit zum Verweisen auf andere Ressourcen bereitzustellen, die eine einfache Durchquerung von Links ermöglicht.
TestSuiteCloneRequest	Anforderung zum Klonen der Testsammlung

CloneOperationInformation

Details zum Klonvorgang.

Name	Typ	Beschreibung
cloneStatistics	CloneStatistics	Klonen von Statistiken
completionDate	string	Wenn der Vorgang abgeschlossen ist, wird dateTime des Abschlusses angezeigt. Wenn der Vorgang nicht abgeschlossen ist, ist dies DateTime.MaxValue.
creationDate	string	DateTime, wann der Vorgang gestartet wurde
destinationObject	ShallowReference	Flacher Verweis des Ziels
destinationPlan	ShallowReference	Flacher Verweis des Ziels
destinationProject	ShallowReference	Flacher Verweis des Ziels
message	string	Wenn der Vorgang fehlgeschlagen ist, enthält Message den Grund für den Fehler. Andernfalls NULL.
opId	integer	Die ID des Vorgangs
resultObjectType	ResultObjectType	Der Typ des Objekts, das als Ergebnis des Klonvorgangs generiert wurde.
sourceObject	ShallowReference	Flacher Verweis der Quelle
sourcePlan	ShallowReference	Flacher Verweis der Quelle
sourceProject	ShallowReference	Flacher Verweis der Quelle
state	CloneOperationState	Aktueller Status des Vorgangs. Wenn Der Status den Status "Erfolgreich" oder "Fehlgeschlagen" erreicht, ist der Vorgang abgeschlossen.
url	string	URL zum Abrufen der Kloninformationen

CloneOperationState

Aktueller Status des Vorgangs. Wenn Der Status den Status "Erfolgreich" oder "Fehlgeschlagen" erreicht, ist der Vorgang abgeschlossen.

Name	Typ	Beschreibung
failed	string	Wert für fehlerbehafteten Zustand
inProgress	string	Wert für Den Status "Inprogress"
queued	string	Wert für Status in der Warteschlange
succeeded	string	Wert für Erfolgszustand

CloneOptions

Name	Typ	Beschreibung
cloneRequirements	boolean	Wenn auf true festgelegt, werden Anforderungen geklont.
copyAllSuites	boolean	Kopieren aller Suites aus einem Quellplan
copyAncestorHierarchy	boolean	Kopieren des Vorgängers hieracrchy
destinationWorkItemType	string	Name des Arbeitselementtyps des Klons
overrideParameters	object	Schlüsselwertpaare, bei denen der Schlüsselwert durch den -Wert überschrieben wird.
relatedLinkComment	string	Kommentieren Sie den Link, der den neuen Klontestfall mit dem ursprünglichen Set NULL verknüpft, um keinen Kommentar zu erhalten.

CloneStatistics

Name	Typ	Beschreibung
clonedRequirementsCount	integer	Anzahl der bisher geklonten Requirments.
clonedSharedStepsCount	integer	Anzahl der bisher geklonten freigegebenen Schritte.
clonedTestCasesCount	integer	Anzahl der bisher geklonten Testfälle
totalRequirementsCount	integer	Gesamtanzahl der zu klonenden Anforderungen
totalTestCasesCount	integer	Gesamtanzahl der zu klonenden Testfälle

ResultObjectType

Der Typ des Objekts, das als Ergebnis des Klonvorgangs generiert wurde.

Name	Typ	Beschreibung
testPlan	string	Planen des Klonens
testSuite	string	Suite Klonen

ShallowReference

Ein abstrahierter Verweis auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge mit einer einheitlichen Möglichkeit zum Verweisen auf andere Ressourcen bereitzustellen, die eine einfache Durchquerung von Links ermöglicht.

Name	Typ	Beschreibung
id	string	ID der Ressource
name	string	Name der verknüpften Ressource (Definitionsname, Controllername usw.)
url	string	Vollständiger HTTP-Link zur Ressource

TestSuiteCloneRequest

Anforderung zum Klonen der Testsammlung

Name	Typ	Beschreibung
cloneOptions	CloneOptions	Klonoptionen zum Klonen der Testsammlung.
destinationSuiteId	integer	Suite-ID, unter der wir die Suite klonen müssen.
destinationSuiteProjectName	string	Name des Zielsammlungsprojekts.

Freigeben über