Freigeben über

Processes - Import Process Template

  • Referenz
Dienst:
Work Item Tracking Process Template
API-Version:
7.1

Importiert einen Prozess aus zip-Datei.

POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?api-version=7.1
Mit optionalen Parametern: 
POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?ignoreWarnings={ignoreWarnings}&replaceExistingTemplate={replaceExistingTemplate}&api-version=7.1

URI-Parameter

Name In Erforderlich Typ Beschreibung
organization
 path True

string

Der Name der Azure DevOps-Organisation.
api-version
 query True

string

Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.
ignoreWarnings
 query

boolean

Ignoriert Überprüfungswarnungen. Der Standardwert ist "false".
replaceExistingTemplate
 query

boolean

Ersetzt die vorhandene Vorlage. Der Standardwert ist true.

Anforderungstext

Media Types: "application/octet-stream"

Name Typ Beschreibung
body

string (Stream)

Stream zum Hochladen

Antworten

Name Typ Beschreibung
200 OK

ProcessImportResult

Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

Name Beschreibung
vso.work_write Gewährt die Möglichkeit, Arbeitsaufgaben und Abfragen zu lesen, zu erstellen und zu aktualisieren, Boardmetadaten zu aktualisieren, Bereiche und Iterationspfade für andere Pfade für die Nachverfolgung verwandter Arbeitsaufgaben zu aktualisieren, Abfragen auszuführen und Benachrichtigungen über Arbeitsaufgabenereignisse über Diensthaken zu erhalten.

Beispiele

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
CheckTemplateExistenceResult

Beschreibt das Ergebnis einer Anforderung zum Vorhandensein einer Überprüfungsvorlage.
ProcessImportResult

Beschreibt das Ergebnis einer Prozessimportanforderung.
ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Objekt

Beschreibt das Ergebnis einer Anforderung zum Vorhandensein einer Überprüfungsvorlage.

Name Typ Beschreibung
doesTemplateExist

boolean

Gibt an, ob eine Vorlage vorhanden ist.
existingTemplateName

string

Der Name der vorhandenen Vorlage.
existingTemplateTypeId

string (uuid)

Der vorhandene Vorlagentypbezeichner.
requestedTemplateName

string

Der Name der angeforderten Vorlage.

ProcessImportResult

Objekt

Beschreibt das Ergebnis einer Prozessimportanforderung.

Name Typ Beschreibung
checkExistenceResult

CheckTemplateExistenceResult

Überprüfen Sie das Ergebnis der Vorlagenexistenz.
helpUrl

string

Hilfe-URL.
id

string (uuid)

ID des Importvorgangs.
isNew

boolean

Gibt an, ob dieser importierte Prozess neu ist.
promoteJobId

string (uuid)

Die Höherstufen-Auftrags-ID.
validationResults

ValidationIssue[]

Die Liste der Überprüfungsergebnisse.

ValidationIssue

Objekt
Name Typ Beschreibung
description

string

file

string

helpLink

string

issueType

ValidationIssueType

line

integer (int32)

ValidationIssueType

Enumeration
Wert Beschreibung
error
warning