Compartir a través de

Processes - Import Process Template

  • Referencia
Servicio:
Work Item Tracking Process Template
Versión de la API:
7.1

Importa un proceso desde el archivo ZIP.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
 path True

string

Nombre de la organización de Azure DevOps.
api-version
 query True

string

Versión de la API que se va a usar. Debe establecerse en "7.1" para usar esta versión de la API.
ignoreWarnings
 query

boolean

Omite las advertencias de validación. El valor predeterminado es false.
replaceExistingTemplate
 query

boolean

Reemplaza la plantilla existente. El valor predeterminado es true.

Cuerpo de la solicitud

Media Types: "application/octet-stream"

Nombre Tipo Description
body

string (Stream)

Transmisión para cargar

Respuestas

Nombre Tipo Description
200 OK

ProcessImportResult

operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del 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

Ámbitos

Nombre Description
vso.work_write Concede la capacidad de leer, crear y actualizar elementos de trabajo y consultas, actualizar metadatos del panel de actualización, áreas de lectura e iteraciones rutas de acceso a otros metadatos relacionados con el seguimiento de elementos de trabajo, ejecutar consultas y recibir notificaciones sobre eventos de elemento de trabajo a través de enlaces de servicio.

Ejemplos

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
CheckTemplateExistenceResult

Describe el resultado de una solicitud de existencia de plantilla de comprobación.
ProcessImportResult

Describe el resultado de una solicitud de importación de procesos.
ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Object

Describe el resultado de una solicitud de existencia de plantilla de comprobación.

Nombre Tipo Description
doesTemplateExist

boolean

Indica si existe una plantilla.
existingTemplateName

string

Nombre de la plantilla existente.
existingTemplateTypeId

string (uuid)

Identificador de tipo de plantilla existente.
requestedTemplateName

string

Nombre de la plantilla solicitada.

ProcessImportResult

Object

Describe el resultado de una solicitud de importación de procesos.

Nombre Tipo Description
checkExistenceResult

CheckTemplateExistenceResult

Compruebe el resultado de la existencia de la plantilla.
helpUrl

string

Dirección URL de ayuda.
id

string (uuid)

Identificador de la operación de importación.
isNew

boolean

Indica si este proceso importado es nuevo.
promoteJobId

string (uuid)

Identificador de trabajo de promoción.
validationResults

ValidationIssue[]

Lista de resultados de validación.

ValidationIssue

Object
Nombre Tipo Description
description

string

file

string

helpLink

string

issueType

ValidationIssueType

line

integer (int32)

ValidationIssueType

Enumeración
Valor Description
error
warning