Clone Operation - Clone Test Plan
Клонирование плана тестирования
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. |
plan
|
path | True |
integer int32 |
Идентификатор клонированного плана тестирования. |
project
|
path | True |
string |
Идентификатор или имя проекта |
api-version
|
query | True |
string |
Используемая версия API. Для использования этой версии API необходимо задать значение 5.0-preview.2. |
Текст запроса
Имя | Тип | Описание |
---|---|---|
destinationTestPlan |
Ресурс плана тестирования. |
|
options | ||
suiteIds |
integer[] |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
успешная операция |
Безопасность
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
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
{
"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"
}
Определения
Имя | Описание |
---|---|
Clone |
Сведения об операции клонирования. |
Clone |
Текущее состояние операции. Когда состояние достигает suceeded или Failed, операция завершается |
Clone |
|
Clone |
|
Identity |
|
Reference |
Класс, представляющий коллекцию ссылок REST. |
Release |
Ссылка на ресурс среды выпуска. |
Result |
Тип объекта, созданного в результате операции клонирования. |
Shallow |
Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразным способом ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам. |
Test |
Параметры результатов теста |
Test |
Ресурс плана тестирования. |
Test |
CloneOperationInformation
Сведения об операции клонирования.
Имя | Тип | Описание |
---|---|---|
cloneStatistics |
Статистика клонирования |
|
completionDate |
string |
Если операция завершена, дата и время завершения. Если операция не завершена, это DateTime.MaxValue. |
creationDate |
string |
Дата и время начала операции |
destinationObject |
Неглубокая ссылка на назначение |
|
destinationPlan |
Неглубокая ссылка на назначение |
|
destinationProject |
Неглубокая ссылка на назначение |
|
message |
string |
Если операция завершилась сбоем, сообщение содержит причину сбоя. В противном случае - значение NULL. |
opId |
integer |
Идентификатор операции |
resultObjectType |
Тип объекта, созданного в результате операции клонирования. |
|
sourceObject |
Неглубокая ссылка на источник |
|
sourcePlan |
Неглубокая ссылка на источник |
|
sourceProject |
Неглубокая ссылка на источник |
|
state |
Текущее состояние операции. Когда состояние достигает 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 |
Это поле содержит ноль или более интересных ссылок на тему графа. Эти ссылки можно вызвать для получения дополнительных связей или более подробных сведений об этой теме графа. |
|
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 |
Область плана тестирования. |
|
build |
Сборка для тестирования. |
|
buildDefinition |
Определение сборки, создающее сборку, связанную с этим планом тестирования. |
|
description |
string |
Описание плана тестирования. |
endDate |
string |
Дата окончания плана тестирования. |
id |
integer |
Идентификатор плана тестирования. |
iteration |
string |
Путь итерации плана тестирования. |
name |
string |
Имя плана тестирования. |
owner |
Владелец плана тестирования. |
|
previousBuild |
Абстрактная ссылка на какой-то другой ресурс. Этот класс используется для предоставления контрактам данных сборки единообразным способом ссылки на другие ресурсы таким образом, чтобы обеспечить простой обход по ссылкам. |
|
project |
Проект, содержащий план тестирования. |
|
releaseEnvironmentDefinition |
Среда выпуска, используемая для развертывания сборки и запуска автоматических тестов из этого плана тестирования. |
|
revision |
integer |
Пересмотр плана тестирования. |
rootSuite |
Корневой набор тестов плана тестирования. |
|
startDate |
string |
Дата начала плана тестирования. |
state |
string |
Состояние плана тестирования. |
testOutcomeSettings |
Значение для настройки того, как должны вести себя одни и те же тесты в наборах тестов в рамках плана тестирования |
|
updatedBy | ||
updatedDate |
string |
|
url |
string |
URL-адрес ресурса плана тестирования. |
TestPlanCloneRequest
Имя | Тип | Описание |
---|---|---|
destinationTestPlan |
Ресурс плана тестирования. |
|
options | ||
suiteIds |
integer[] |