Clone Operation - Clone Test Suite

Usługa:

Test

Wersja interfejsu API:

5.0-preview.2

Klonowanie zestawu testów

POST https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/Suites/{sourceSuiteId}/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 testowego, w którym ma zostać sklonowany pakiet, jest obecny
project	path	True	string	Identyfikator projektu lub nazwa projektu
sourceSuiteId	path	True	integer int32	Identyfikator zestawu testów do sklonowania
api-version	query	True	string	Wersja interfejsu API do użycia. Powinno to być ustawione na wartość "5.0-preview.2", aby używać tej wersji interfejsu API.

Treść żądania

Nazwa	Typ	Opis
cloneOptions	CloneOptions	Opcje klonowania zestawu testów.
destinationSuiteId	integer	Identyfikator pakietu, w ramach którego musimy sklonować pakiet.
destinationSuiteProjectName	string	Nazwa projektu pakietu docelowego.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CloneOperationInformation	operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
CloneOperationInformation	Szczegółowe informacje o operacji klonowania.
CloneOperationState	Bieżący stan operacji. Gdy stan osiągnie powodzenie lub niepowodzenie, operacja zostanie ukończona
CloneOptions
CloneStatistics
ResultObjectType	Typ obiektu wygenerowanego w wyniku operacji Clone
ShallowReference	Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolitym sposobem odwołowania się do innych zasobów w sposób, który zapewnia łatwy przechodzenie za pośrednictwem linków.
TestSuiteCloneRequest	Żądanie klonowania zestawu testów

CloneOperationInformation

Object

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 zostanie ukończona, jest to DateTime.MaxValue
creationDate	string	Data/godzina rozpoczęcia operacji
destinationObject	ShallowReference	Płytkie odwołanie do miejsca docelowego
destinationPlan	ShallowReference	Płytkie odwołanie do miejsca docelowego
destinationProject	ShallowReference	Płytkie odwołanie 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 Clone
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 powodzenie lub niepowodzenie, operacja zostanie ukończona
url	string	Adres URL pobierania informacji o klonowaniu

CloneOperationState

Enumeration

Bieżący stan operacji. Gdy stan osiągnie powodzenie lub niepowodzenie, operacja zostanie ukończona

Wartość	Opis
failed	wartość dla stanu niepowodzenie
inProgress	wartość stanu inprogress
queued	Wartość stanu w kolejce
succeeded	wartość stanu powodzenia

CloneOptions

Object

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 workitem klonu
overrideParameters	object	Pary wartości klucza, 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 ustawieniem null bez komentarza

CloneStatistics

Object

Nazwa	Typ	Opis
clonedRequirementsCount	integer	Liczba dozorców sklonowanych do tej pory.
clonedSharedStepsCount	integer	Liczba kroków udostępnionych 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

ResultObjectType

Enumeration

Typ obiektu wygenerowanego w wyniku operacji Clone

Wartość	Opis
testPlan	Klonowanie planu
testSuite	Klonowanie pakietu

ShallowReference

Object

Abstrakcyjne odwołanie do innego zasobu. Ta klasa służy do dostarczania kontraktów danych kompilacji z jednolitym sposobem odwołowania się do innych zasobów w sposób, który zapewnia łatwy 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

TestSuiteCloneRequest

Object

Żądanie klonowania zestawu testów

Nazwa	Typ	Opis
cloneOptions	CloneOptions	Opcje klonowania zestawu testów.
destinationSuiteId	integer	Identyfikator pakietu, w ramach którego musimy sklonować pakiet.
destinationSuiteProjectName	string	Nazwa projektu pakietu docelowego.