Udostępnij za pośrednictwem

Processes - Import Process Template

  • Odwołanie
Usługa:
Work Item Tracking Process Template
Wersja interfejsu API:
7.1

Importuje proces z pliku zip.

POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?api-version=7.1
Z parametrami opcjonalnymi: 
POST https://dev.azure.com/{organization}/_apis/work/processadmin/processes/import?ignoreWarnings={ignoreWarnings}&replaceExistingTemplate={replaceExistingTemplate}&api-version=7.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. Należy ustawić wartość "7.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 (Stream)

Przesyłanie strumieniowe do przekazania

Odpowiedzi

Nazwa Typ Opis
200 OK

ProcessImportResult

operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
202 
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 importu procesu.
ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Objekt

Opisuje wynik żądania istnienia szablonu sprawdzania.

Nazwa Typ Opis
doesTemplateExist

boolean

Wskazuje, czy istnieje szablon.
existingTemplateName

string

Nazwa istniejącego szablonu.
existingTemplateTypeId

string (uuid)

Istniejący identyfikator typu szablonu.
requestedTemplateName

string

Nazwa żądanego szablonu.

ProcessImportResult

Objekt

Opisuje wynik żądania importu procesu.

Nazwa Typ Opis
checkExistenceResult

CheckTemplateExistenceResult

Sprawdź wynik istnienia szablonu.
helpUrl

string

Adres URL pomocy.
id

string (uuid)

Identyfikator operacji importowania.
isNew

boolean

Czy ten importowany proces jest nowy.
promoteJobId

string (uuid)

Identyfikator zadania podwyższania poziomu.
validationResults

ValidationIssue[]

Lista wyników weryfikacji.

ValidationIssue

Objekt
Nazwa Typ Opis
description

string

file

string

helpLink

string

issueType

ValidationIssueType

line

integer (int32)

ValidationIssueType

Wyliczanie
Wartość Opis
error
warning