Condividi tramite

Processes - Import Process Template

  • Riferimento
Servizio:
Work Item Tracking Process Template
Versione API:
7.1

Importa un processo dal file ZIP.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
 path True

string

Nome dell'organizzazione di Azure DevOps.
api-version
 query True

string

Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API.
ignoreWarnings
 query

boolean

Ignora gli avvisi di convalida. Il valore predefinito è false.
replaceExistingTemplate
 query

boolean

Sostituisce il modello esistente. Il valore predefinito è true.

Corpo della richiesta

Media Types: "application/octet-stream"

Nome Tipo Descrizione
body

string (Stream)

Flusso da caricare

Risposte

Nome Tipo Descrizione
200 OK

ProcessImportResult

operazione riuscita

Sicurezza

oauth2

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Ambiti

Nome Descrizione
vso.work_write Concede la possibilità di leggere, creare e aggiornare elementi di lavoro e query, aggiornare i metadati della scheda, l'area di lettura e le iterazioni percorsi di altri metadati correlati di rilevamento degli elementi di lavoro, eseguire query e ricevere notifiche sugli eventi degli elementi di lavoro tramite hook del servizio.

Esempio

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
CheckTemplateExistenceResult

Descrive il risultato di una richiesta di esistenza del modello di controllo.
ProcessImportResult

Descrive il risultato di una richiesta di importazione del processo.
ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Object

Descrive il risultato di una richiesta di esistenza del modello di controllo.

Nome Tipo Descrizione
doesTemplateExist

boolean

Indica se esiste un modello.
existingTemplateName

string

Nome del modello esistente.
existingTemplateTypeId

string (uuid)

Identificatore del tipo di modello esistente.
requestedTemplateName

string

Nome del modello richiesto.

ProcessImportResult

Object

Descrive il risultato di una richiesta di importazione del processo.

Nome Tipo Descrizione
checkExistenceResult

CheckTemplateExistenceResult

Controllare il risultato dell'esistenza del modello.
helpUrl

string

URL della Guida.
id

string (uuid)

ID dell'operazione di importazione.
isNew

boolean

Indica se il processo importato è nuovo.
promoteJobId

string (uuid)

Identificatore del processo di promozione.
validationResults

ValidationIssue[]

Elenco dei risultati della convalida.

ValidationIssue

Object
Nome Tipo Descrizione
description

string

file

string

helpLink

string

issueType

ValidationIssueType

line

integer (int32)

ValidationIssueType

Enumerazione
Valore Descrizione
error
warning