Groups - Move Group To Section

服务:

Work Item Tracking Process

API 版本:

7.1

将组移动到其他分区。

PUT https://dev.azure.com/{organization}/_apis/work/processes/{processId}/workItemTypes/{witRefName}/layout/pages/{pageId}/sections/{sectionId}/groups/{groupId}?removeFromSectionId={removeFromSectionId}&api-version=7.1

URI 参数

名称	在	必需	类型	说明
groupId	path	True	string	组的 ID。
organization	path	True	string	Azure DevOps 组织的名称。
pageId	path	True	string	组位于的页面的 ID。
processId	path	True	string (uuid)	进程的 ID。
sectionId	path	True	string	组位于的分区的 ID。
witRefName	path	True	string	工作项类型的引用名称。
api-version	query	True	string	要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。
removeFromSectionId	query	True	string	要从中删除组的节的 ID。

请求正文

名称	类型	说明
contribution	WitContribution	组的贡献。
controls	Control[]	要放入组中的控件。
height	integer (int32)	贡献的高度。
id	string	布局节点的 ID。
inherited	boolean	一个值，该值指示此布局节点是否继承自父布局。 这应仅由合并器设置。
isContribution	boolean	一个值，该值指示布局节点是否参与。
label	string	组的标签。
order	integer (int32)	组应在节中显示的顺序。
overridden	boolean	一个值，该值指示此布局节点是否已由子布局重写。
visible	boolean	一个值，该值指示组是否应隐藏。

响应

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

安全性

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	授予读取、创建和更新工作项和查询、更新板元数据、读取区域和迭代路径、其他工作项跟踪相关元数据、执行查询以及通过服务挂钩接收有关工作项事件的通知的能力。

示例

Move a group to a different section

示例请求

HTTP

PUT https://dev.azure.com/{organization}/_apis/work/processes/{processId}/workItemTypes/{witRefName}/layout/pages/{pageId}/sections/{sectionId}/groups/{groupId}?api-version=7.1

{
  "id": "faf0f718-776c-422a-9424-3c5f7952901c",
  "label": "NewGroup1",
  "controls": null,
  "order": 1,
  "visible": true,
  "contribution": null,
  "isContribution": false,
  "height": null
}

示例响应

状态代码:

200

{
  "id": "faf0f718-776c-422a-9424-3c5f7952901c",
  "label": "NewGroup1",
  "isContribution": false,
  "visible": true,
  "controls": []
}

定义

名称	说明
Control	表示窗体中的控件。
Group	表示窗体中保存控件的组。
WitContribution	工作项表单贡献的属性

Control

Object

表示窗体中的控件。

名称	类型	说明
contribution	WitContribution	控件的贡献。
controlType	string	控件的类型。
height	integer (int32)	控件的高度，对于 html 控件。
id	string	布局节点的 ID。
inherited	boolean	一个值，该值指示是否已继承此布局节点。 从父布局。 这应仅由合并器设置。
isContribution	boolean	一个值，该值指示布局节点是否参与。
label	string	字段的标签。
metadata	string	控件的内部文本。
order	integer (int32)	控件应在其组中显示的顺序。
overridden	boolean	一个值，该值指示是否已重写此布局节点。 按子布局。
readOnly	boolean	一个值，指示控件是否是只读的。
visible	boolean	一个值，指示控件是否应隐藏。
watermark	string	文本框的水印文本。

Group

Object

表示窗体中保存控件的组。

名称	类型	说明
contribution	WitContribution	组的贡献。
controls	Control[]	要放入组中的控件。
height	integer (int32)	贡献的高度。
id	string	布局节点的 ID。
inherited	boolean	一个值，该值指示此布局节点是否继承自父布局。 这应仅由合并器设置。
isContribution	boolean	一个值，该值指示布局节点是否参与。
label	string	组的标签。
order	integer (int32)	组应在节中显示的顺序。
overridden	boolean	一个值，该值指示此布局节点是否已由子布局重写。
visible	boolean	一个值，该值指示组是否应隐藏。

WitContribution

Object

工作项表单贡献的属性

名称	类型	说明
contributionId	string	贡献的 ID。
height	integer (int32)	贡献的高度。
inputs	object	保存供稿输入的键值对的字典。
showOnDeletedWorkItem	boolean	一个值，该值指示是否应在已删除的工作项上显示贡献。