Clone Operation - Clone Test Plan

Odwołanie

Service:: Test

API Version:: 5.0-preview.2

Klonowanie planu testu

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
planId	path	True	integer int32	Identyfikator planu testów, który ma zostać sklonowany.
project	path	True	string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Ta wartość powinna mieć wartość "5.0-preview.2", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa	Typ	Opis
destinationTestPlan	TestPlan	Zasób planu testów.
options	CloneOptions
suiteIds	integer[]

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CloneOperationInformation	operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa	Opis
vso.test_write	Umożliwia odczytywanie, tworzenie i aktualizowanie planów testów, przypadków, wyników i innych artefaktów związanych z zarządzaniem testami.

Przykłady

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

Definicje

Nazwa	Opis
CloneOperationInformation	Szczegółowe informacje o operacji klonowania.
CloneOperationState	Bieżący stan operacji. Gdy stan osiągnie wartość Powodzenie lub Niepowodzenie, operacja zostanie ukończona
CloneOptions
CloneStatistics
IdentityRef
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
ReleaseEnvironmentDefinitionReference	Odwołanie do zasobu środowiska wydania.
ResultObjectType	Typ obiektu wygenerowanego w wyniku operacji Klonowanie
ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji w jednolity sposób odwoływanie się do innych zasobów w sposób, który zapewnia łatwe przechodzenie za pośrednictwem linków.
TestOutcomeSettings	Ustawienia wyników testu
TestPlan	Zasób planu testów.
TestPlanCloneRequest

CloneOperationInformation

Szczegółowe informacje o operacji klonowania.

Nazwa	Typ	Opis
cloneStatistics	CloneStatistics	Sklonuj statystyki
completionDate	string	Jeśli operacja zostanie ukończona, data/godzina ukończenia. Jeśli operacja nie została ukończona, jest to DateTime.MaxValue
creationDate	string	Data/godzina rozpoczęcia operacji
destinationObject	ShallowReference	Płytkie odniesienie do miejsca docelowego
destinationPlan	ShallowReference	Płytkie odniesienie do miejsca docelowego
destinationProject	ShallowReference	Płytkie odniesienie do miejsca docelowego
message	string	Jeśli operacja zakończyła się niepowodzeniem, komunikat zawiera przyczynę niepowodzenia. W przeciwnym razie wartość null.
opId	integer	Identyfikator operacji
resultObjectType	ResultObjectType	Typ obiektu wygenerowanego w wyniku operacji Klonowanie
sourceObject	ShallowReference	Płytkie odwołanie do źródła
sourcePlan	ShallowReference	Płytkie odwołanie do źródła
sourceProject	ShallowReference	Płytkie odwołanie do źródła
state	CloneOperationState	Bieżący stan operacji. Gdy stan osiągnie wartość Powodzenie lub Niepowodzenie, operacja zostanie ukończona
url	string	Adres URL pobierania informacji o klonie

CloneOperationState

Bieżący stan operacji. Gdy stan osiągnie wartość Powodzenie lub Niepowodzenie, operacja zostanie ukończona

Nazwa	Typ	Opis
failed	string	wartość stanu niepowodzenie
inProgress	string	wartość stanu inprogress
queued	string	Wartość stanu w kolejce
succeeded	string	wartość stanu Powodzenie

CloneOptions

Nazwa	Typ	Opis
cloneRequirements	boolean	W przypadku ustawienia wartości true wymagania zostaną sklonowane
copyAllSuites	boolean	kopiowanie wszystkich pakietów z planu źródłowego
copyAncestorHierarchy	boolean	copy ancestor hieracrchy
destinationWorkItemType	string	Nazwa typu elementu roboczego klonu
overrideParameters	object	Pary klucz-wartość, w których wartość klucza jest zastępowana przez wartość.
relatedLinkComment	string	Komentarz do linku, który połączy nowy przypadek testowy klonowania z oryginalnym zestawem wartości null bez komentarza

CloneStatistics

Nazwa	Typ	Opis
clonedRequirementsCount	integer	Liczba próbek sklonowanych do tej pory.
clonedSharedStepsCount	integer	Liczba udostępnionych kroków sklonowanych do tej pory.
clonedTestCasesCount	integer	Liczba przypadków testowych sklonowanych do tej pory
totalRequirementsCount	integer	Łączna liczba wymagań do sklonowania
totalTestCasesCount	integer	Łączna liczba przypadków testowych do sklonowania

IdentityRef

Nazwa	Typ	Opis
_links	ReferenceLinks	To pole zawiera zero lub więcej interesujących linków dotyczących tematu grafu. Te linki mogą być wywoływane w celu uzyskania dodatkowych relacji lub bardziej szczegółowych informacji na temat tego tematu grafu.
descriptor	string	Deskryptor jest podstawowym sposobem odwoływanie się do tematu grafu podczas działania systemu. To pole będzie jednoznacznie identyfikować ten sam temat grafu zarówno w ramach kont, jak i organizacji.
directoryAlias	string
displayName	string	Jest to nieu unikatowa nazwa wyświetlana podmiotu grafu. Aby zmienić to pole, należy zmienić jego wartość u dostawcy źródłowego.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

ReleaseEnvironmentDefinitionReference

Odwołanie do zasobu środowiska wydania.

Nazwa	Typ	Opis
definitionId	integer	Identyfikator definicji wydania zawierającej definicję środowiska wydania.
environmentDefinitionId	integer	Identyfikator definicji środowiska wydania.

ResultObjectType

Typ obiektu wygenerowanego w wyniku operacji Klonowanie

Nazwa	Typ	Opis
testPlan	string	Klonowanie planu
testSuite	string	Klonowanie pakietu

ShallowReference

Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji w jednolity sposób odwoływanie się do innych zasobów w sposób, który zapewnia łatwe przechodzenie za pośrednictwem linków.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu
name	string	Nazwa połączonego zasobu (nazwa definicji, nazwa kontrolera itp.)
url	string	Pełny link HTTP do zasobu

TestOutcomeSettings

Ustawienia wyników testu

Nazwa	Typ	Opis
syncOutcomeAcrossSuites	boolean	Wartość służąca do konfigurowania sposobu wyświetlania wyników testów dla tych samych testów między zestawami

TestPlan

Zasób planu testów.

Nazwa	Typ	Opis
area	ShallowReference	Obszar planu testów.
build	ShallowReference	Kompilacja do przetestowania.
buildDefinition	ShallowReference	Definicja kompilacji, która generuje kompilację skojarzona z tym planem testu.
description	string	Opis planu testu.
endDate	string	Data zakończenia planu testu.
id	integer	Identyfikator planu testów.
iteration	string	Ścieżka iteracji planu testu.
name	string	Nazwa planu testu.
owner	IdentityRef	Właściciel planu testów.
previousBuild	ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji w jednolity sposób odwoływanie się do innych zasobów w sposób, który zapewnia łatwe przechodzenie za pośrednictwem linków.
project	ShallowReference	Projekt zawierający plan testu.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Środowisko wydania używane do wdrażania kompilacji i uruchamiania testów automatycznych z tego planu testów.
revision	integer	Poprawka planu testu.
rootSuite	ShallowReference	Główny zestaw testów planu testu.
startDate	string	Data rozpoczęcia planu testu.
state	string	Stan planu testu.
testOutcomeSettings	TestOutcomeSettings	Wartość określająca, jak te same testy między zestawami testów w ramach planu testów muszą zachowywać się
updatedBy	IdentityRef
updatedDate	string
url	string	Adres URL zasobu planu testów.

TestPlanCloneRequest

Nazwa	Typ	Opis
destinationTestPlan	TestPlan	Zasób planu testów.
options	CloneOptions
suiteIds	integer[]

Udostępnij za pośrednictwem