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 パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前。
api-version	query	True	string	使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1' に設定する必要があります。
ignoreWarnings	query		boolean	検証の警告を無視します。 既定値は false です。
replaceExistingTemplate	query		boolean	既存のテンプレートを置き換えます。 既定値は true です。

要求本文

Media Types: "application/octet-stream"

名前	型	説明
body	string (Stream)	アップロードするストリーム

応答

名前	型	説明
200 OK	ProcessImportResult	成功した操作

セキュリティ

oauth2

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL (トークン 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

スコープ

名前	説明
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
}

定義

名前	説明
CheckTemplateExistenceResult	テンプレートの存在確認要求の結果について説明します。
ProcessImportResult	プロセス インポート要求の結果について説明します。
ValidationIssue
ValidationIssueType

CheckTemplateExistenceResult

Object

テンプレートの存在確認要求の結果について説明します。

名前	型	説明
doesTemplateExist	boolean	テンプレートが存在するかどうかを示します。
existingTemplateName	string	既存のテンプレートの名前。
existingTemplateTypeId	string (uuid)	既存のテンプレート型識別子。
requestedTemplateName	string	要求されたテンプレートの名前。

ProcessImportResult

Object

プロセス インポート要求の結果について説明します。

名前	型	説明
checkExistenceResult	CheckTemplateExistenceResult	テンプレートの存在結果を確認します。
helpUrl	string	ヘルプ URL。
id	string (uuid)	インポート操作の ID。
isNew	boolean	このインポートされたプロセスが新しいかどうか。
promoteJobId	string (uuid)	昇格ジョブ識別子。
validationResults	ValidationIssue[]	検証結果の一覧。

ValidationIssue

Object

名前	型	説明
description	string
file	string
helpLink	string
issueType	ValidationIssueType
line	integer (int32)

ValidationIssueType

列挙

値	説明
error
warning