Processes - Import Process Template

服務:

Work Item Tracking Process Template

API 版本:

7.1

從 zip 檔案匯入程式。

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

含選擇性參數:

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

URI 參數

名稱	位於	必要	類型	Description
organization	path	True	string	Azure DevOps 組織的名稱。
api-version	query	True	string	要使用的 API 版本。 這應該設定為 『7.1』 以使用此版本的 API。
ignoreWarnings	query		boolean	忽略驗證警告。 默認值為 false。
replaceExistingTemplate	query		boolean	取代現有的範本。 默認值為 true。

要求本文

Media Types: "application/octet-stream"

名稱	類型	Description
body	string (Stream)	要上傳的串流

回應

名稱	類型	Description
200 OK	ProcessImportResult	成功作業

安全性

oauth2

類型: oauth2
Flow: accessCode
授權 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
權杖 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

範圍

名稱	Description
vso.work_write	授與讀取、建立和更新工作專案和查詢、更新面板元數據、讀取區域和反覆專案路徑的能力，其他工作專案追蹤相關元數據、執行查詢，以及透過服務攔截接收工作專案事件的通知。

範例

範例要求

HTTP

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

範例回覆

狀態碼:

202

persistent-Auth: true
lfs-Authenticate: NTLM

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

定義

名稱	Description
CheckTemplateExistenceResult	描述檢查範本存在要求的結果。
ProcessImportResult	描述進程匯入要求的結果。
ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Object

描述檢查範本存在要求的結果。

名稱	類型	Description
doesTemplateExist	boolean	指出範本是否存在。
existingTemplateName	string	現有範本的名稱。
existingTemplateTypeId	string (uuid)	現有的範本類型識別碼。
requestedTemplateName	string	要求之範本的名稱。

ProcessImportResult

Object

描述進程匯入要求的結果。

名稱	類型	Description
checkExistenceResult	CheckTemplateExistenceResult	檢查範本是否存在結果。
helpUrl	string	說明 URL。
id	string (uuid)	匯入作業的標識碼。
isNew	boolean	這個匯入的程式是否為新的。
promoteJobId	string (uuid)	升階作業標識碼。
validationResults	ValidationIssue[]	驗證結果的清單。

ValidationIssue

Object

名稱	類型	Description
description	string
file	string
helpLink	string
issueType	ValidationIssueType
line	integer (int32)

ValidationIssueType

列舉型別

值	Description
error
warning