Compartilhar via

Processes - Import Process Template

  • Referência
Serviço:
Work Item Tracking Process Template
Versão da API:
7.1

Importa um processo do arquivo zip.

POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?api-version=7.1
Com parâmetros opcionais: 
POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?ignoreWarnings={ignoreWarnings}&replaceExistingTemplate={replaceExistingTemplate}&api-version=7.1

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
 path True

string

O nome da organização do Azure DevOps.
api-version
 query True

string

Versão da API a ser usada. Isso deve ser definido como '7.1' para usar essa versão da api.
ignoreWarnings
 query

boolean

Ignora avisos de validação. O valor padrão é falso.
replaceExistingTemplate
 query

boolean

Substitui o modelo existente. O valor padrão é verdadeiro.

Corpo da solicitação

Media Types: "application/octet-stream"

Nome Tipo Description
body

string (Stream)

Transmitir para carregar

Respostas

Nome Tipo Description
200 OK

ProcessImportResult

operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do Token: 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

Escopos

Nome Description
vso.work_write Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler área e iterações caminhos de outros metadados relacionados ao item de trabalho, executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Exemplos

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
202 
persistent-Auth: true
lfs-Authenticate: NTLM
{
  "id": "adcc42ab-9882-485e-a3ed-7678f01f66bd",
  "promoteJobId": "00000000-0000-0000-0000-000000000000",
  "helpUrl": null,
  "validationResults": [],
  "isNew": false
}

Definições

Nome Description
CheckTemplateExistenceResult

Descreve o resultado de uma solicitação de existência de modelo de verificação.
ProcessImportResult

Descreve o resultado de uma solicitação de Importação de Processo.
ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Objeto

Descreve o resultado de uma solicitação de existência de modelo de verificação.

Nome Tipo Description
doesTemplateExist

boolean

Indica se existe um modelo.
existingTemplateName

string

O nome do modelo existente.
existingTemplateTypeId

string (uuid)

O identificador de tipo de modelo existente.
requestedTemplateName

string

O nome do modelo solicitado.

ProcessImportResult

Objeto

Descreve o resultado de uma solicitação de Importação de Processo.

Nome Tipo Description
checkExistenceResult

CheckTemplateExistenceResult

Verifique o resultado da existência do modelo.
helpUrl

string

URL de ajuda.
id

string (uuid)

ID da operação de importação.
isNew

boolean

Se esse processo importado é novo.
promoteJobId

string (uuid)

O identificador de trabalho de promoção.
validationResults

ValidationIssue[]

A lista de resultados de validação.

ValidationIssue

Objeto
Nome Tipo Description
description

string

file

string

helpLink

string

issueType

ValidationIssueType

line

integer (int32)

ValidationIssueType

Enumeração
Valor Description
error
warning