Clone Operation - Clone Test Plan

Ссылка

Service:: Test

API Version:: 5.0-preview.2

Клонирование плана тестирования

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

Параметры URI

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

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

Имя	Тип	Описание
destinationTestPlan	TestPlan	Ресурс плана тестирования.
options	CloneOptions
suiteIds	integer[]

Ответы

Имя	Тип	Описание
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/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"
}

Определения

Имя	Описание
CloneOperationInformation	Сведения об операции клонирования.
CloneOperationState	Текущее состояние операции. Когда состояние достигает suceeded или Failed, операция завершается
CloneOptions
CloneStatistics
IdentityRef
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
ReleaseEnvironmentDefinitionReference	Ссылка на ресурс среды выпуска.
ResultObjectType	Тип объекта, созданного в результате операции клонирования.
ShallowReference	Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразным способом ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам.
TestOutcomeSettings	Параметры результатов теста
TestPlan	Ресурс плана тестирования.
TestPlanCloneRequest

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	Общее число клонированных тестовых случаев

IdentityRef

Имя	Тип	Описание
_links	ReferenceLinks	Это поле содержит ноль или более интересных ссылок на тему графа. Эти ссылки можно вызвать для получения дополнительных связей или более подробных сведений об этой теме графа.
descriptor	string	Дескриптор является основным способом ссылки на субъект графа во время работы системы. Это поле однозначно идентифицирует одну и ту же тему графа как в учетных записях, так и в организациях.
directoryAlias	string
displayName	string	Это неуникальное отображаемое имя субъекта графа. Чтобы изменить это поле, необходимо изменить его значение в поставщике источника.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Этот URL-адрес представляет собой полный маршрут к исходному ресурсу этого субъекта графа.

ReferenceLinks

Класс, представляющий коллекцию ссылок REST.

Имя	Тип	Описание
links	object	Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения.

ReleaseEnvironmentDefinitionReference

Ссылка на ресурс среды выпуска.

Имя	Тип	Описание
definitionId	integer	Идентификатор определения выпуска, содержащего определение среды выпуска.
environmentDefinitionId	integer	Идентификатор определения среды выпуска.

ResultObjectType

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

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

ShallowReference

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

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

TestOutcomeSettings

Параметры результатов теста

Имя	Тип	Описание
syncOutcomeAcrossSuites	boolean	Значение для настройки отображения результатов теста для одного и того же набора

TestPlan

Ресурс плана тестирования.

Имя	Тип	Описание
area	ShallowReference	Область плана тестирования.
build	ShallowReference	Сборка для тестирования.
buildDefinition	ShallowReference	Определение сборки, создающее сборку, связанную с этим планом тестирования.
description	string	Описание плана тестирования.
endDate	string	Дата окончания плана тестирования.
id	integer	Идентификатор плана тестирования.
iteration	string	Путь итерации плана тестирования.
name	string	Имя плана тестирования.
owner	IdentityRef	Владелец плана тестирования.
previousBuild	ShallowReference	Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразным способом ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам.
project	ShallowReference	Проект, содержащий план тестирования.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Среда выпуска, используемая для развертывания сборки и запуска автоматических тестов из этого плана тестирования.
revision	integer	Пересмотр плана тестирования.
rootSuite	ShallowReference	Корневой набор тестов плана тестирования.
startDate	string	Дата начала плана тестирования.
state	string	Состояние плана тестирования.
testOutcomeSettings	TestOutcomeSettings	Значение для настройки того, как должны вести себя одни и те же тесты в наборах тестов в рамках плана тестирования
updatedBy	IdentityRef
updatedDate	string
url	string	URL-адрес ресурса плана тестирования.

TestPlanCloneRequest

Имя	Тип	Описание
destinationTestPlan	TestPlan	Ресурс плана тестирования.
options	CloneOptions
suiteIds	integer[]

Share via