添加工作项标记以对列表和板进行分类和筛选

Azure DevOps Services |Azure DevOps Server 2022 |Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018

标记工作项可帮助你按你定义的类别快速筛选产品积压工作或工作项查询。 标记对应于一个或两个关键字短语,该短语支持筛选积压工作或查询或定义查询的需求。

标记是筛选工作项比使用文本字符串更好的选择,如 指南中所述,用于创建高性能查询

可以从用于 Visual Studio 的团队资源管理器插件从 Web 门户添加和修改标记。 此外,还可以在 Excel 中打开查询以批量修改标记。

备注

标记是共享资源,它们与项目相关联,而不是团队。 如果项目包含多个团队,则所有团队都将在同一组标记中添加和工作。

先决条件

  • 必须连接到项目。 如果还没有项目, 请创建一个项目
  • 必须添加到项目。 若要添加, 请将用户添加到项目或团队
  • 若要查看或修改工作项,必须 在此节点中拥有“查看工作项 ”和“ 编辑此节点 ”权限设置为 “允许”的工作项。 默认情况下, 参与者 组具有此权限集。 若要了解详细信息,请参阅 设置工作跟踪的权限和访问权限
  • 若要添加新标记以添加到工作项,必须具有 基本 访问权限或更高版本,并且项目级别“ 创建新标记定义 ”权限设置为 “允许”。 默认情况下, 参与者 组具有此权限集。 即使为 利益干系人显式设置了权限,他们也无权添加新标记,因为它们通过访问级别被禁止。 若要了解详细信息,请参阅 利益干系人访问快速参考
  • 所有项目成员(即使是属于 读者 组的成员)都可以通过电子邮件发送工作项。
  • 必须连接到项目。 如果还没有项目, 请创建一个项目
  • 必须添加到项目。 若要添加, 请将用户添加到项目或团队
  • 若要查看或修改工作项,必须 在此节点中拥有“查看工作项 ”和“ 编辑此节点 ”权限设置为 “允许”的工作项。 默认情况下, 参与者 组具有此权限集。 若要了解详细信息,请参阅 设置工作跟踪的权限和访问权限
  • 若要添加新标记以添加到工作项,必须具有 基本 访问权限或更高版本,并且项目级别“ 创建新标记定义 ”权限设置为 “允许”。 默认情况下, 参与者 组具有此权限集。 即使为 利益干系人显式设置了权限,他们也无权添加新标记,因为它们通过访问级别被禁止。 若要了解详细信息,请参阅 利益干系人访问快速参考
  • 所有项目成员(即使是属于 读者 组的成员)都可以通过电子邮件发送工作项。

备注

允许对公共项目具有 利益干系人 访问权限的用户添加新标记。

向工作项添加标记

标记应为 400 个字符或更少,不包含 (逗号) 、 ; (分号) 或其他格式字符等,分隔符。

提示

建议不要在 @ 标记中使用字符。 不能在工作项查询中使用以 @ 字符开头的标记。 该 @ 字符表示查询中的宏,因此无法将标记识别为标记。

从 Web 门户打开工作项并添加标记。 选择 “添加标记 ”并键入关键字。 或者,从之前分配的标记的列表中进行选择。

向工作项添加一个或多个标记

若要一次性添加多个标记,请在各个标记之间键入逗号。 标记是区分大小写的。

标记栏中显示的标记已分配给工作项。 若要取消分配标记,请选择标记上的 x,删除分配给工作项的标记

备注

默认情况下,向公共项目的所有参与者和利益干系人授予添加新标记和现有标记的权限。 私有项目中的利益干系人可以添加已定义的标记,但不能添加新标记。 若要授予或限制创建新标记的权限,请在项目级别设置权限 “创建标记定义 ”。 若要了解详细信息,请参阅 更改项目级权限

批量添加或删除标记

你可以批量更新工作项,以便从 Web 门户添加或删除标记。 使用 Web 门户批量修改标记的方式与批量修改其他字段的方式相同。 或者,可以使用 Excel 批量添加或删除标记。

“编辑工作项”对话框,批量添加到多个工作项。

备注

不支持从 Visual Studio 或其他受支持的客户端批量修改标记。

基于标记查询工作项

若要基于标记查询工作项,请为每个要用于支持查询的标记添加子句。

提示

可以使用 ContainsNot Contain 运算符。 以字符开头 @ 的标记不能用于工作项查询,因为查询编辑器将 @ 字符解释为宏。 若要了解有关查询的详细信息,请参阅 创建托管查询

例如,此处我们查询标记WebService或标记的所有工作项。

要查询标记的查询编辑器的屏幕截图。

提示

若要了解如何 AND/OR 对子句进行分组,请参阅 创建和保存托管查询、Group 子句。 若要查看查询的 WIQL 语法,请安装 WIQL 查询编辑器扩展 ,以便查看任何查询编辑器条目的 WIQL 版本。

备注

查询没有附加到它们的任何标记的工作项的功能不受支持。 如果要对支持此功能的请求进行投票,可以在我们的开发者社区页面上执行此操作,以便能够搜索空标记

显示积压工作 (backlog) 或查询结果中的标记

选择 “列选项 ”,将 “标记 ”字段添加到产品积压工作项查询。 如果未显示此选项,请选择 “更多”命令 ,从选项菜单中将其选中。

“列选项”对话框,“向要显示的选定列添加标记”。

所有已添加到列出的工作项的标记都显示。

产品积压工作屏幕截图,其中添加了“标记”列。

使用标记筛选列表

在 Web 门户中,可以使用标记筛选积压工作、板和查询结果。

首先选择 筛选器

选中要筛选的这些标记的框。 保留 OR 选择以运行所选的所有标记的逻辑 OR。 或者,选择 AND 选项以在所有所选标记上运行逻辑 AND。

添加“标记”列后的视图

删除、删除或管理标记

无法删除标记本身。 但是,如果从标记当前分配到的所有工作项中删除该标记,则系统将删除该标记。 系统会自动删除有三天时间未使用的未分配标记。

如果拼写错误标记,请不要将拼写错误的标记分配给任何工作项,系统将在三天内自动将其删除。

另一种选择是安装市场标记管理器,该管理器在 BoardsWork 下添加“标记”页来管理标记。

板上的颜色代码标记

可以通过颜色编码来突出显示看板卡片上的标记。 这些颜色仅显示在配置的看板上。 它们不会显示在积压工作或任务板上。 若要了解详细信息,请参阅 自定义卡片、颜色代码标记

“板>设置>标记颜色”对话框

按标记绘制工作项和分组的图表

备注

但是,不能按标记对基于查询的图表进行分组,但是,可以按添加到仪表板的标记对 “工作项图表 ”小组件进行分组。 此功能目前以公共预览版提供。 若要启用它,请参阅 “管理”或“启用功能” ,并在 仪表板上为工作项图表小组件启用按标记分组。

若要按标记对 “工作项图表”小组件 进行分组,请使用 基于状态和趋势查询的图表完成“跟踪进度”中提供的相同步骤,将图表小组件添加到仪表板。 确保平面列表查询包含查询子句中的 标记 或列选项。 然后,按选择选择选择“组”选择“标记”。 若要筛选图表以仅显示某些标记,请选择 “所选标记 ”单选按钮,然后选择希望图表显示的标记。

按工作项、配置、按标记分组的图表屏幕截图。

市场扩展

标记数限制

虽然不存在硬限制,但为项目集合创建超过 100,000 个标记可能会对性能产生负面影响。 此外,标记控件的自动完成下拉菜单最多显示 200 个标记。 定义超过 200 个标记时,开始键入以导致标记控件显示相关标记。

不能将超过 100 个标记分配给工作项,否则将收到以下消息:

TF401243: Failed to save work item because too many new tags were added to the work item.

使用已添加的标记 (100 或更少) 保存工作项,然后可以添加更多标记。

将查询限制为 25 个以下的标记。 超过该数量,查询可能会超时。

将标记添加到产品积压工作的默认列视图

若要将 “标记” 字段添加为产品积压工作列字段,请修改 ProcessConfiguration 文件以包含 System.Tags。 若要了解如何操作,请参阅 进程配置 XML 元素参考