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

Processes - Import Process Template

  • Ссылка
Служба:
Work Item Tracking Process Template
Версия API:
7.1

Импортирует процесс из ZIP-файла.

POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?api-version=7.1
С использованием необязательных параметров: 
POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?ignoreWarnings={ignoreWarnings}&replaceExistingTemplate={replaceExistingTemplate}&api-version=7.1

Параметры URI

Имя В Обязательно Тип Описание
organization
 path True

string

Имя организации Azure DevOps.
api-version
 query True

string

Используемая версия API. Для использования этой версии API необходимо задать значение "7.1".
ignoreWarnings
 query

boolean

Игнорирует предупреждения проверки. Значение по умолчанию — false.
replaceExistingTemplate
 query

boolean

Заменяет существующий шаблон. Значение по умолчанию — true.

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

Media Types: "application/octet-stream"

Имя Тип Описание
body

string (Stream)

Поток для отправки

Ответы

Имя Тип Описание
200 OK

ProcessImportResult

успешная операция

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

oauth2

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
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

Области

Имя Описание
vso.work_write Предоставляет возможность читать, создавать и обновлять рабочие элементы и запросы, метаданные доски обновления, области чтения и итерации пути других связанных метаданных рабочих элементов, выполнять запросы и получать уведомления о событиях рабочих элементов с помощью перехватчиков служб.

Примеры

Образец запроса

POST https://dev.azure.com/fabrikam/_apis/work/processadmin/processes/import?api-version=7.1

Пример ответа

Код состояния:
202 
persistent-Auth: true
lfs-Authenticate: NTLM
{
  "id": "adcc42ab-9882-485e-a3ed-7678f01f66bd",
  "promoteJobId": "00000000-0000-0000-0000-000000000000",
  "helpUrl": null,
  "validationResults": [],
  "isNew": false
}

Определения

Имя Описание
CheckTemplateExistenceResult

Описывает результат запроса на существование шаблона проверки.
ProcessImportResult

Описывает результат запроса импорта процесса.
ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Object

Описывает результат запроса на существование шаблона проверки.

Имя Тип Описание
doesTemplateExist

boolean

Указывает, существует ли шаблон.
existingTemplateName

string

Имя существующего шаблона.
existingTemplateTypeId

string (uuid)

Идентификатор существующего типа шаблона.
requestedTemplateName

string

Имя запрошенного шаблона.

ProcessImportResult

Object

Описывает результат запроса импорта процесса.

Имя Тип Описание
checkExistenceResult

CheckTemplateExistenceResult

Проверьте результат существования шаблона.
helpUrl

string

URL-адрес справки.
id

string (uuid)

Идентификатор операции импорта.
isNew

boolean

Является ли этот импортированный процесс новым.
promoteJobId

string (uuid)

Идентификатор задания повышения уровня.
validationResults

ValidationIssue[]

Список результатов проверки.

ValidationIssue

Object
Имя Тип Описание
description

string

file

string

helpLink

string

issueType

ValidationIssueType

line

integer (int32)

ValidationIssueType

Перечисление
Значение Описание
error
warning