Behaviors - Update

服务:

Work Item Tracking Process

API 版本:

7.1

替换进程中的行为。

PUT https://dev.azure.com/{organization}/_apis/work/processes/{processId}/behaviors/{behaviorRefName}?api-version=7.1

URI 参数

名称	在	必需	类型	说明
behaviorRefName	path	True	string	行为的引用名称
organization	path	True	string	Azure DevOps 组织的名称。
processId	path	True	string (uuid)	进程的 ID
api-version	query	True	string	要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。

请求正文

名称	类型	说明
color	string	颜色。
name	string	行为名称。

响应

名称	类型	说明
200 OK	ProcessBehavior	成功作

安全性

oauth2

类型: oauth2
流向: 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

作用域

名称	说明
vso.work_write	授予读取、创建和更新工作项和查询、更新板元数据、读取区域和迭代路径、其他工作项跟踪相关元数据、执行查询以及通过服务挂钩接收有关工作项事件的通知的能力。

示例

Update a process behavior

示例请求

HTTP

PUT https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Custom.4b8fdba0-7064-458d-b55c-522b39059a62?api-version=7.1

{
  "name": "NewCustomBehavior",
  "color": "FFFABC"
}

示例响应

状态代码:

200

{
  "name": "NewCustomBehavior",
  "referenceName": "Custom.4b8fdba0-7064-458d-b55c-522b39059a62",
  "color": "FFFABC",
  "rank": 50,
  "description": null,
  "customization": "custom",
  "fields": [
    {
      "name": "Stack Rank",
      "referenceName": "Microsoft.VSTS.Common.StackRank",
      "url": "https://dev.azure.com/fabrikam/_apis/wit/fields/Microsoft.VSTS.Common.StackRank"
    }
  ],
  "inherits": {
    "behaviorRefName": "System.PortfolioBacklogBehavior",
    "url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/System.PortfolioBacklogBehavior"
  },
  "url": "https://dev.azure.com/fabrikam/_apis/work/processes/906c7065-2a04-4f61-aac1-b5da9cef040b/behaviors/Custom.4b8fdba0-7064-458d-b55c-522b39059a62"
}

定义

名称	说明
CustomizationType	指示此工作项的自定义类型。 系统行为继承自父进程，但未修改。 继承的行为是从父进程继承的修改行为。 自定义行为是由用户在当前进程中创建的行为。
ProcessBehavior	进程行为模型。
ProcessBehaviorField	处理行为字段。
ProcessBehaviorReference	进程行为参考。
ProcessBehaviorUpdateRequest	进程行为替换有效负载。

CustomizationType

枚举

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

值	说明
custom	如果新创建的工作项类型已自定义，则自定义类型为 Custom。
inherited	如果自定义了继承进程的现有工作项类型，则自定义自定义类型。
system	自定义类型为 System（如果系统生成的 workitemtype）。

ProcessBehavior

Object

进程行为模型。

名称	类型	说明
color	string	颜色。
customization	CustomizationType	指示此工作项的自定义类型。 系统行为继承自父进程，但未修改。 继承的行为是从父进程继承的修改行为。 自定义行为是由用户在当前进程中创建的行为。
description	string	. 描述
fields	ProcessBehaviorField[]	处理行为字段。
inherits	ProcessBehaviorReference	父行为引用。
name	string	行为名称。
rank	integer (int32)	行为排名
referenceName	string	行为 ID
url	string	行为的 URL。

ProcessBehaviorField

Object

处理行为字段。

名称	类型	说明
name	string	字段的名称。
referenceName	string	字段的引用名称。
url	string	指向字段的 URL。

ProcessBehaviorReference

Object

进程行为参考。

名称	类型	说明
behaviorRefName	string	行为 ID。
url	string	行为 URL。

ProcessBehaviorUpdateRequest

Object

进程行为替换有效负载。

名称	类型	说明
color	string	颜色。
name	string	行为名称。