Processes - List

取得包括系統和繼承在內的所有進程清單。

GET https://dev.azure.com/{organization}/_apis/work/processes?api-version=7.1-preview.2
GET https://dev.azure.com/{organization}/_apis/work/processes?$expand={$expand}&api-version=7.1-preview.2

URI 參數

名稱 位於 必要 類型 Description
organization
path True

string

Azure DevOps 組織的名稱。

api-version
query True

string

要使用的 API 版本。 這應該設定為 '7.1-preview.2' 以使用此版本的 API。

$expand
query

GetProcessExpandLevel

回應

名稱 類型 Description
200 OK

ProcessInfo[]

成功的作業

安全性

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

名稱 Description
vso.work 授與讀取工作專案、查詢、面板、區域和反復專案路徑,以及其他工作專案追蹤相關中繼資料的能力。 也授與執行查詢、搜尋工作專案,以及透過服務勾點接收工作專案事件通知的能力。

範例

Get the list of processes

Sample Request

GET https://dev.azure.com/{organization}/_apis/work/processes?api-version=7.1-preview.2

Sample Response

{
  "count": 14,
  "value": [
    {
      "typeId": "adcc42ab-9882-485e-a3ed-7678f01f66bc",
      "referenceName": null,
      "name": "Agile",
      "description": "This template is flexible and will work great for most teams using Agile planning methods, including those practicing Scrum.",
      "parentProcessTypeId": "00000000-0000-0000-0000-000000000000",
      "isEnabled": true,
      "isDefault": true,
      "customizationType": "System"
    },
    {
      "typeId": "27450541-8e31-4150-9947-dc59f998fc01",
      "referenceName": null,
      "name": "CMMI",
      "description": "This template is for more formal projects requiring a framework for process improvement and an auditable record of decisions.",
      "parentProcessTypeId": "00000000-0000-0000-0000-000000000000",
      "isEnabled": true,
      "isDefault": false,
      "customizationType": "System"
    },
    {
      "typeId": "6b724908-ef14-45cf-84f8-768b5384da45",
      "referenceName": null,
      "name": "Scrum",
      "description": "This template is for teams who follow the Scrum framework.",
      "parentProcessTypeId": "00000000-0000-0000-0000-000000000000",
      "isEnabled": true,
      "isDefault": false,
      "customizationType": "System"
    },
    {
      "typeId": "e31fd6e1-c6af-44bb-925e-dfa71f551463",
      "referenceName": null,
      "name": "CustomProcess",
      "description": "This template is flexible and will work great for most teams using Agile planning methods, including those practicing Scrum.",
      "parentProcessTypeId": "00000000-0000-0000-0000-000000000000",
      "isEnabled": true,
      "isDefault": false,
      "customizationType": "Inherited"
    }
  ]
}

定義

名稱 Description
CustomizationType

指出此工作專案上的自訂類型。 系統行為繼承自父進程,但未修改。 繼承的行為是繼承自父進程的行為。 自訂行為是目前進程中使用者所建立的行為。

GetProcessExpandLevel
ProcessInfo

處理。

ProjectReference

定義專案參考類別。

CustomizationType

指出此工作專案上的自訂類型。 系統行為繼承自父進程,但未修改。 繼承的行為是繼承自父進程的行為。 自訂行為是目前進程中使用者所建立的行為。

名稱 類型 Description
custom

string

如果已自訂新建立的工作專案類型,則 Custom-type 為 Custom。

inherited

string

如果已自訂繼承進程的現有工作專案類型,則自訂自訂類型為 Inherited。

system

string

自訂類型是系統產生的 workitemtype,則為 System。

GetProcessExpandLevel

名稱 類型 Description
none

string

沒有展開層級。

projects

string

專案展開層級。

ProcessInfo

處理。

名稱 類型 Description
customizationType

CustomizationType

指出此程式的自訂類型。 系統進程是預設進程。 繼承的進程已修改為系統進程之前的進程。

description

string

程式的描述。

isDefault

boolean

這是進程預設值。

isEnabled

boolean

是否已啟用進程。

name

string

進程的名稱。

parentProcessTypeId

string

父進程的識別碼。

projects

ProjectReference[]

在此程式中訂閱使用者的專案。

referenceName

string

進程的參考名稱。

typeId

string

進程的識別碼。

ProjectReference

定義專案參考類別。

名稱 類型 Description
description

string

專案的描述

id

string

專案的識別碼

name

string

專案的名稱

url

string

專案的 URL