Processes - List

參考

服務:: Work Item Tracking Process

API 版本:: 7.1

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

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

含選擇性參數:

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

URI 參數

名稱	位於	必要	類型	Description
organization	path	True	string	Azure DevOps 組織的名稱。
api-version	query	True	string	要使用的 API 版本。這應該設定為『7.1』以使用此版本的 API。
$expand	query		GetProcessExpandLevel

回應

名稱	類型	Description
200 OK	ProcessInfo[]	成功作業

安全性

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	授與讀取工作項目、查詢、面板、區域和反覆項目路徑，以及其他工作專案追蹤相關元數據的能力。同時授與執行查詢、搜尋工作專案，以及透過服務攔截接收工作專案事件的通知的能力。

範例

Get the list of processes

範例要求

HTTP

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

範例回覆

狀態碼:: 200

{
  "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	如果新建立的工作項目類型已自定義，則自定義類型為 Custom。
inherited	如果已自定義繼承程式的現有工作項目類型，則會繼承自定義自定義類型。
system	如果系統產生的 workitemtype，則自定義類型為 System。

GetProcessExpandLevel

列舉型別

值	Description
none	沒有展開層級。
projects	項目展開層級。

ProcessInfo

Object

過程。

名稱	類型	Description
customizationType	CustomizationType	指出此程式的自定義類型。系統進程是預設進程。繼承的進程已修改為系統進程之前的進程。
description	string	程式的描述。
isDefault	boolean	這是進程預設值。
isEnabled	boolean	是否已啟用進程。
name	string	進程的名稱。
parentProcessTypeId	string (uuid)	父進程的標識碼。
projects	ProjectReference[]	此程式中使用者訂閱的專案。
referenceName	string	進程的參考名稱。
typeId	string (uuid)	進程的標識碼。

ProjectReference