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 参数

名称 必需 类型 说明
organization
path True

string

Azure DevOps 组织的名称。

api-version
query True

string

要使用的 API 版本。 应将其设置为“7.1-preview.2”才能使用此版本的 API。

$expand
query

GetProcessExpandLevel

响应

名称 类型 说明
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

名称 说明
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"
    }
  ]
}

定义

名称 说明
CustomizationType

指示此工作项的自定义类型。 系统行为继承自父进程,但未修改。 继承的行为是从父进程继承的修改行为。 自定义行为是用户在当前进程中创建的行为。

GetProcessExpandLevel
ProcessInfo

处理。

ProjectReference

定义项目引用类。

CustomizationType

指示此工作项的自定义类型。 系统行为继承自父进程,但未修改。 继承的行为是从父进程继承的修改行为。 自定义行为是用户在当前进程中创建的行为。

名称 类型 说明
custom

string

如果自定义了新创建的 workitemtype,则 Customization-type 为 Custom。

inherited

string

如果自定义继承进程的现有工作项类型,则 Customization-type 为 Inherited。

system

string

如果 是系统生成的 workitemtype,则 Customization-type 为 System。

GetProcessExpandLevel

名称 类型 说明
none

string

无展开级别。

projects

string

项目展开级别。

ProcessInfo

处理。

名称 类型 说明
customizationType

CustomizationType

指示此过程的自定义类型。 系统进程是默认进程。 继承的进程是以前是系统进程的修改进程。

description

string

过程的说明。

isDefault

boolean

进程默认值。

isEnabled

boolean

进程是否已启用。

name

string

进程的名称。

parentProcessTypeId

string

父进程的 ID。

projects

ProjectReference[]

此进程中用户订阅的项目。

referenceName

string

进程的引用名称。

typeId

string

进程的 ID。

ProjectReference

定义项目引用类。

名称 类型 说明
description

string

项目说明

id

string

项目的 ID

name

string

项目的名称

url

string

项目的 URL