Partager via

Processes - Import Process Template

  • Référence
Service:
Work Item Tracking Process Template
Version d'API:
7.1

Importe un processus à partir du fichier zip.

POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?api-version=7.1
Avec des paramètres facultatifs: 
POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?ignoreWarnings={ignoreWarnings}&replaceExistingTemplate={replaceExistingTemplate}&api-version=7.1

Paramètres URI

Nom Dans Obligatoire Type Description
organization
 path True

string

Nom de l’organisation Azure DevOps.
api-version
 query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1 » pour utiliser cette version de l’API.
ignoreWarnings
 query

boolean

Ignore les avertissements de validation. La valeur par défaut est false.
replaceExistingTemplate
 query

boolean

Remplace le modèle existant. La valeur par défaut est true.

Corps de la demande

Media Types: "application/octet-stream"

Nom Type Description
body

string (Stream)

Flux à charger

Réponses

Nom Type Description
200 OK

ProcessImportResult

opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom Description
vso.work_write Octroie la possibilité de lire, de créer et de mettre à jour des éléments de travail et des requêtes, de mettre à jour des métadonnées de carte, de lire des zones de lecture et des itérations chemins d’accès à d’autres métadonnées associées au suivi des éléments de travail, d’exécuter des requêtes et de recevoir des notifications sur les événements d’élément de travail via des hooks de service.

Exemples

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
CheckTemplateExistenceResult

Décrit le résultat d’une demande d’existence de modèle de vérification.
ProcessImportResult

Décrit le résultat d’une demande d’importation de processus.
ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Object

Décrit le résultat d’une demande d’existence de modèle de vérification.

Nom Type Description
doesTemplateExist

boolean

Indique si un modèle existe.
existingTemplateName

string

Nom du modèle existant.
existingTemplateTypeId

string (uuid)

Identificateur de type de modèle existant.
requestedTemplateName

string

Nom du modèle demandé.

ProcessImportResult

Object

Décrit le résultat d’une demande d’importation de processus.

Nom Type Description
checkExistenceResult

CheckTemplateExistenceResult

Vérifiez le résultat de l’existence du modèle.
helpUrl

string

URL d’aide.
id

string (uuid)

ID de l’opération d’importation.
isNew

boolean

Indique si ce processus importé est nouveau.
promoteJobId

string (uuid)

Identificateur du travail de promotion.
validationResults

ValidationIssue[]

Liste des résultats de validation.

ValidationIssue

Object
Nom Type Description
description

string

file

string

helpLink

string

issueType

ValidationIssueType

line

integer (int32)

ValidationIssueType

Énumération
Valeur Description
error
warning