Clone Operation - Clone Test Plan

Referenz

Service:: Test

API Version:: 5.0-preview.2

Klonen des Testplans

POST https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/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 zu klonenden Testplans.
project	path	True	string	Projekt-ID oder Projektname
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
destinationTestPlan	TestPlan	Die Testplanressource.
options	CloneOptions
suiteIds	integer[]

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

Definitionen

Name	Beschreibung
CloneOperationInformation	Details zum Klonvorgang.
CloneOperationState	Aktueller Status des Vorgangs. Wenn der Zustand erfolgreich oder fehlgeschlagen ist, ist der Vorgang abgeschlossen.
CloneOptions
CloneStatistics
IdentityRef
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
ReleaseEnvironmentDefinitionReference	Verweis auf die Releaseumgebungsressource.
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 bereitzustellen, andere Ressourcen auf eine Weise zu verweisen, die eine einfache Durchquerung von Links ermöglicht.
TestOutcomeSettings	Testergebniseinstellungen
TestPlan	Die Testplanressource.
TestPlanCloneRequest

CloneOperationInformation

Details zum Klonvorgang.

Name	Typ	Beschreibung
cloneStatistics	CloneStatistics	Statistiken klonen
completionDate	string	Wenn der Vorgang abgeschlossen ist, ist die DateTime der Fertigstellung. Wenn der Vorgang nicht abgeschlossen ist, ist dies DateTime.MaxValue.
creationDate	string	DateTime, wann der Vorgang gestartet wurde
destinationObject	ShallowReference	Flache Referenz des Ziels
destinationPlan	ShallowReference	Flache Referenz des Ziels
destinationProject	ShallowReference	Flache Referenz des Ziels
message	string	Wenn der Vorgang fehlgeschlagen ist, enthält die Nachricht 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	Flache Referenz der Quelle
sourcePlan	ShallowReference	Flache Referenz der Quelle
sourceProject	ShallowReference	Flache Referenz der Quelle
state	CloneOperationState	Aktueller Status des Vorgangs. Wenn der Zustand erfolgreich oder fehlgeschlagen ist, ist der Vorgang abgeschlossen.
url	string	URL zum Abrufen der Kloninformationen

CloneOperationState

Aktueller Status des Vorgangs. Wenn der Zustand erfolgreich oder fehlgeschlagen ist, ist der Vorgang abgeschlossen.

Name	Typ	Beschreibung
failed	string	Wert für Fehlerstatus
inProgress	string	Wert für Den Status "Inprogress"
queued	string	Wert für Warteschlangenstatus
succeeded	string	Wert für den Status "Erfolg"

CloneOptions

Name	Typ	Beschreibung
cloneRequirements	boolean	Wenn auf true festgelegte Anforderungen geklont werden
copyAllSuites	boolean	Kopieren aller Suiten aus einem Quellplan
copyAncestorHierarchy	boolean	Vorgänger hieracrchy kopieren
destinationWorkItemType	string	Name des Arbeitselementtyps des Klons
overrideParameters	object	Schlüsselwertpaare, bei denen der Schlüsselwert vom Wert überschrieben wird.
relatedLinkComment	string	Kommentieren Sie den Link, der den neuen Klontestfall mit dem ursprünglichen Nullwert ohne Kommentar verknüpft.

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

IdentityRef

Name	Typ	Beschreibung
_links	ReferenceLinks	Dieses Feld enthält null oder interessantere Links zum Diagrammthema. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Graph-Thema zu erhalten.
descriptor	string	Der Deskriptor ist die primäre Möglichkeit, auf den Graphengegenstand zu verweisen, während das System ausgeführt wird. In diesem Feld wird derselbe Graph-Betreff sowohl für Konten als auch für Organisationen eindeutig identifiziert.
directoryAlias	string
displayName	string	Dies ist der nicht eindeutige Anzeigename des Diagrammsubjekts. Um dieses Feld zu ändern, müssen Sie seinen Wert im Quellanbieter ändern.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs.

ReferenceLinks

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

ReleaseEnvironmentDefinitionReference

Verweis auf die Releaseumgebungsressource.

Name	Typ	Beschreibung
definitionId	integer	ID der Releasedefinition, die die Releaseumgebungsdefinition enthält.
environmentDefinitionId	integer	ID der Releaseumgebungsdefinition.

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 bereitzustellen, andere Ressourcen auf eine Weise zu verweisen, 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

TestOutcomeSettings

Testergebniseinstellungen

Name	Typ	Beschreibung
syncOutcomeAcrossSuites	boolean	Wert zum Konfigurieren der Darstellung von Testergebnissen für dieselben Tests in verschiedenen Suiten

TestPlan

Die Testplanressource.

Name	Typ	Beschreibung
area	ShallowReference	Bereich des Testplans.
build	ShallowReference	Zu testende Build.
buildDefinition	ShallowReference	Die Builddefinition, die einen diesem Testplan zugeordneten Build generiert.
description	string	Beschreibung des Testplans.
endDate	string	Enddatum für den Testplan.
id	integer	ID des Testplans.
iteration	string	Iterationspfad des Testplans.
name	string	Name des Testplans.
owner	IdentityRef	Besitzer des Testplans.
previousBuild	ShallowReference	Ein abstrahierter Verweis auf eine andere Ressource. Diese Klasse wird verwendet, um die Builddatenverträge mit einer einheitlichen Möglichkeit bereitzustellen, andere Ressourcen auf eine Weise zu verweisen, die eine einfache Durchquerung von Links ermöglicht.
project	ShallowReference	Projekt, das den Testplan enthält.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Releaseumgebung, die zum Bereitstellen des Builds und Ausführen automatisierter Tests aus diesem Testplan verwendet werden soll.
revision	integer	Revision des Testplans.
rootSuite	ShallowReference	Stammtestsuite des Testplans.
startDate	string	Startdatum für den Testplan.
state	string	Status des Testplans.
testOutcomeSettings	TestOutcomeSettings	Wert zum Konfigurieren, wie sich dieselben Tests in Testsammlungen unter einem Testplan verhalten müssen
updatedBy	IdentityRef
updatedDate	string
url	string	URL der Testplanressource.

TestPlanCloneRequest

Name	Typ	Beschreibung
destinationTestPlan	TestPlan	Die Testplanressource.
options	CloneOptions
suiteIds	integer[]

Freigeben über