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

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

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

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

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

注意

标记是共享资源,它们与项目(而不是团队)相关联。 如果项目包含多个团队,则所有团队都将添加到同一组标记并处理。

先决条件

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

注意

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

将标记添加到工作项

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

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

Add one or more tags to a work item

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

标记栏中显示的标记已分配给工作项。 若要取消分配标记,请选择标记Delete a tag assigned to a work item上的 x。

注意

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

批量添加或删除标记

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

Edit work items dialog, Bulk add to several work items.

注意

不支持从 Visual Studio 客户端批量修改标记。

基于标记查询工作项

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

提示

可以使用 ContainsNot Contain 运算符。 若要了解有关查询的详细信息,请参阅 创建托管查询

例如,此处查询标记 Web 的所有工作项或 Service

Screenshot of Query Editor to query on tags.

提示

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

注意

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

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

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

Column options dialog, Add Tags to the selected columns to display.

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

Screenshot of product backlog, View with Tags column added.

使用标记筛选列表

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

首先选择 筛选器

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

View with Tags column added

删除、删除或管理标记

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

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

另一个选项是安装市场标记管理器,该管理器在“Boards”或“工作”下添加“标记”页以管理标记。

板上的颜色代码标记

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

Boards>Settings>Tag colors dialog

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

注意

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

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

Screenshot of Chart by Work Items, Configure, Group by Tags.

标记数限制

虽然不存在硬限制,但为项目集合创建超过 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 元素参考