Processes - Import Process Template

Référence

Service:: Work Item Tracking Process Template

API Version:: 7.1-preview.1

Importe un processus à partir d’un fichier zip.

POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?api-version=7.1-preview.1

With optional parameters:

POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?ignoreWarnings={ignoreWarnings}&replaceExistingTemplate={replaceExistingTemplate}&api-version=7.1-preview.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-preview.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	Flux à charger

Réponses

Nom	Type	Description
200 OK	ProcessImportResult	opération réussie

Sécurité

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

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

Exemples

Sample Request

HTTP

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

Sample Response

Status code:: 202

persistent-Auth: true
lfs-Authenticate: NTLM

Response Body

{
  "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 case activée.
ProcessImportResult	Décrit le résultat d’une demande d’importation de processus.
ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Décrit le résultat d’une demande d’existence de modèle case activée.

Nom	Type	Description
doesTemplateExist	boolean	Indique si un modèle existe.
existingTemplateName	string	Nom du modèle existant.
existingTemplateTypeId	string	Identificateur de type de modèle existant.
requestedTemplateName	string	Nom du modèle demandé.

ProcessImportResult

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 de l’aide.
id	string	ID de l’opération d’importation.
isNew	boolean	Indique si ce processus importé est nouveau.
promoteJobId	string	Identificateur du travail de promotion.
validationResults	ValidationIssue[]	Liste des résultats de validation.

ValidationIssue

Nom	Type	Description
description	string
file	string
helpLink	string
issueType	ValidationIssueType
line	integer

ValidationIssueType

Nom	Type	Description
error	string
warning	string

Partager via