Clone Operation - Clone Test Suite

Ссылка

Service:: Test

API Version:: 5.0-preview.2

Клонирование набора тестов

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Название организации Azure DevOps.
planId	path	True	integer int32	Идентификатор плана тестирования, в котором присутствует клонируемый набор
project	path	True	string	Идентификатор или имя проекта
sourceSuiteId	path	True	integer int32	Идентификатор клонированного набора тестов
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 5.0-preview.2.

Текст запроса

Имя	Тип	Описание
cloneOptions	CloneOptions	Клонирование параметров для клонирования набора тестов.
destinationSuiteId	integer	Идентификатор набора, под которым мы должны клонировать набор.
destinationSuiteProjectName	string	Имя проекта конечного набора.

Ответы

Имя	Тип	Описание
200 OK	CloneOperationInformation	успешная операция

Безопасность

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

Имя	Описание
vso.test_write	Предоставляет возможность читать, создавать и обновлять планы тестирования, случаи, результаты и другие артефакты, связанные с управлением тестированием.

Примеры

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

Определения

Имя	Описание
CloneOperationInformation	Сведения об операции клонирования.
CloneOperationState	Текущее состояние операции. Когда состояние достигает suceeded или Failed, операция завершается
CloneOptions
CloneStatistics
ResultObjectType	Тип объекта, созданного в результате операции клонирования.
ShallowReference	Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразным способом ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам.
TestSuiteCloneRequest	Запрос на клонирование набора тестов

CloneOperationInformation

Сведения об операции клонирования.

Имя	Тип	Описание
cloneStatistics	CloneStatistics	Статистика клонирования
completionDate	string	Если операция завершена, дата и время завершения. Если операция не завершена, это DateTime.MaxValue.
creationDate	string	Дата и время начала операции
destinationObject	ShallowReference	Неглубокая ссылка на назначение
destinationPlan	ShallowReference	Неглубокая ссылка на назначение
destinationProject	ShallowReference	Неглубокая ссылка на назначение
message	string	Если операция завершилась сбоем, сообщение содержит причину сбоя. В противном случае - значение NULL.
opId	integer	Идентификатор операции
resultObjectType	ResultObjectType	Тип объекта, созданного в результате операции клонирования.
sourceObject	ShallowReference	Неглубокая ссылка на источник
sourcePlan	ShallowReference	Неглубокая ссылка на источник
sourceProject	ShallowReference	Неглубокая ссылка на источник
state	CloneOperationState	Текущее состояние операции. Когда состояние достигает suceeded или Failed, операция завершается
url	string	URL-адрес для получения сведений о клоне

CloneOperationState

Текущее состояние операции. Когда состояние достигает suceeded или Failed, операция завершается

Имя	Тип	Описание
failed	string	Значение для состояния сбоя
inProgress	string	значение для состояния Inprogress
queued	string	Значение состояния в очереди
succeeded	string	значение для состояния успешного выполнения

CloneOptions

Имя	Тип	Описание
cloneRequirements	boolean	Если задано значение true, требования будут клонированы
copyAllSuites	boolean	копирование всех наборов из исходного плана
copyAncestorHierarchy	boolean	копирование предка hieracrchy
destinationWorkItemType	string	Имя типа workitem клона
overrideParameters	object	Пары "Значение ключа", в которых значение ключа переопределяется значением .
relatedLinkComment	string	Комментарий к ссылке, которая свяжет новый тестовый случай клона с исходным значением Set NULL без комментариев

CloneStatistics

Имя	Тип	Описание
clonedRequirementsCount	integer	Число клонированных на данный момент запросов.
clonedSharedStepsCount	integer	Количество общих шагов, клонированных на данный момент.
clonedTestCasesCount	integer	Количество клонированных на данный момент тестовых случаев
totalRequirementsCount	integer	Общее число клонированных требований
totalTestCasesCount	integer	Общее число клонированных тестовых случаев

ResultObjectType

Тип объекта, созданного в результате операции клонирования.

Имя	Тип	Описание
testPlan	string	Клонирование плана
testSuite	string	Клонирование набора

ShallowReference

Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразным способом ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам.

Имя	Тип	Описание
id	string	Идентификатор ресурса
name	string	Имя связанного ресурса (имя определения, имя контроллера и т. д.)
url	string	Полная ссылка HTTP на ресурс

TestSuiteCloneRequest

Запрос на клонирование набора тестов

Имя	Тип	Описание
cloneOptions	CloneOptions	Клонирование параметров для клонирования набора тестов.
destinationSuiteId	integer	Идентификатор набора, под которым мы должны клонировать набор.
destinationSuiteProjectName	string	Имя проекта конечного набора.

Share via