Udostępnij za pośrednictwem


Processes - Import Process Template

Importuje proces z pliku zip.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
path True

string

Nazwa organizacji usługi Azure DevOps.

api-version
query True

string

Wersja interfejsu API do użycia. Powinno to być ustawione na wartość "7.1-preview.1", aby używać tej wersji interfejsu API.

ignoreWarnings
query

boolean

Ignoruje ostrzeżenia dotyczące walidacji. Wartość domyślna to false.

replaceExistingTemplate
query

boolean

Zastępuje istniejący szablon. Wartość domyślna to True.

Treść żądania

Media Types: "application/octet-stream"

Nazwa Typ Opis
body

string

Przesyłanie strumieniowe w celu przekazania

Odpowiedzi

Nazwa Typ Opis
200 OK

ProcessImportResult

operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa Opis
vso.work_write Umożliwia odczytywanie, tworzenie i aktualizowanie elementów roboczych i zapytań, metadanych tablicy aktualizacji, ścieżek obszaru odczytu i iteracji innych metadanych powiązanych elementów roboczych, wykonywania zapytań i odbierania powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

Sample Request

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

Sample Response

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

Definicje

Nazwa Opis
CheckTemplateExistenceResult

Opisuje wynik żądania istnienia szablonu sprawdzania.

ProcessImportResult

Opisuje wynik żądania importowania procesu.

ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Opisuje wynik żądania istnienia szablonu sprawdzania.

Nazwa Typ Opis
doesTemplateExist

boolean

Wskazuje, czy szablon istnieje.

existingTemplateName

string

Nazwa istniejącego szablonu.

existingTemplateTypeId

string

Istniejący identyfikator typu szablonu.

requestedTemplateName

string

Nazwa żądanego szablonu.

ProcessImportResult

Opisuje wynik żądania importowania procesu.

Nazwa Typ Opis
checkExistenceResult

CheckTemplateExistenceResult

Sprawdź wynik istnienia szablonu.

helpUrl

string

Adres URL pomocy.

id

string

Identyfikator operacji importowania.

isNew

boolean

Czy ten importowany proces jest nowy.

promoteJobId

string

Identyfikator zadania podwyższania poziomu.

validationResults

ValidationIssue[]

Lista wyników walidacji.

ValidationIssue

Nazwa Typ Opis
description

string

file

string

helpLink

string

issueType

ValidationIssueType

line

integer

ValidationIssueType

Nazwa Typ Opis
error

string

warning

string