Поделиться через


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.

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

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

Определения

Имя Описание
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-адрес представляет собой полный маршрут к исходному ресурсу этого субъекта графа.

Класс, представляющий коллекцию ссылок 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[]