使用工作项模板

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

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

使用工作项模板,可以快速创建已预填充团队常用字段值的工作项。 可以使用工作项模板来创建工作项或对多个工作项进行批量更新。 可以从 Web 门户或 Visual Studio 2015 或更低版本添加和管理工作项模板。 有关显示工作项模板用法的示例,请参阅示例工作项模板

工作项模板不同于流程模板。 有关详细信息,请参阅关于流程和流程模板或默认流程模板的以下特定文章:基本敏捷ScrumCMMI

支持的模板任务

模板任务选项的可用性取决于你的客户端和平台版本。 可以从 Web 门户或 Visual Studio 2015 或更低版本添加和管理工作项模板。 有关详细信息,请参阅本文中的先决条件

如下表所示,✔️ 指示任务可从 Web 门户或从 Visual Studio 2015 或更低版本获取。 (确保根据平台版本选择内容版本)


任务

Web 门户

Visual Studio 2015



管理工作项模板
(定义、编辑、删除、复制链接、创建副本和重命名)








提示

通过 Web 门户定义的模板不同于通过 Visual Studio 定义的模板。 只能通过 Web 门户管理 Web 门户模板并将其应用于工作项。 同样,只能管理、查看 Visual Studio 模板并将其应用于 Visual Studio 中的工作项。 但是,可以使用这两种模板类型的 URL 通过 Web 门户添加工作项。

先决条件

  • 若要在 Web 门户中管理工作项模板,需要加入拥有这些模板的团队。 然后,可以根据需要添加、编辑或删除模板。

  • 需要是项目参与者和团队成员才能在 Web 门户中使用工作项模板。 然后,可以将模板应用于现有工作项。

  • 若要通过 Web 门户添加、捕获、编辑或删除工作项模板,你必须是团队管理员。

  • 若要应用团队模板,你必须是项目的参与者且是定义工作项模板的团队的成员。

将工作项捕获为模板

根据所使用的平台、版本和客户端,可能需要执行不同的步骤来捕获工作项。

通过 Web 门户捕获的模板会被分配一个 GUID。

  1. 从 Web 门户中,打开要用作模板基础的工作项。

  2. 选择 操作图标以打开菜单。 依次选择“模板”、“捕获”。

    Screenshot of Capture work item field definitions as a template, latest version.

    为模板命名,选择要保存模板的团队,并根据需要定义或清除字段。 完成后保存模板。

    Screenshot of Capture template dialog.

  3. 保存模板,然后选择“复制链接”以捕获模板的 URL。

  4. 可以将 URL 链接粘贴到浏览器中以创建工作项,或将其提供给其他人供他们添加工作项。 例如,可以将其作为超链接添加到项目 Wiki以 Markdown 小组件形式添加到仪表板,或添加为其他共享网络资源。

    如果想添加使用其预定义值定义的类型的工作项,则可使用该 URL。

将会为通过 Web 门户捕获的模板分配 GUID。

  1. 从 Web 门户中,打开要用作模板基础的工作项。

    在 Web 门户中,工作项模板与团队相关联。 使用 Web 门户将模板应用于工作项时,只有为团队定义的模板才可访问。

  2. 选择 操作图标以打开菜单。 依次选择“模板”、“捕获”。

    Capture work item field definitions as a template

    为模板命名,并根据需要定义或清除字段。 完成后保存模板。 模板将保存在你在第一步中选择的团队中。

    Capture template dialog

  3. 保存模板后,选择“复制链接”以捕获模板的 URL,可通过该 URL 使用模板添加工作项。

  4. 如果想添加使用其预定义值定义的类型的工作项,则可使用该 URL。

    你可以将此 URL 另存为文本文件,或将 URL 以超链接形式添加到仪表板或网页。

管理工作项模板

对于每个工作项类型,可以查看和管理团队定义的模板。 可以对模板执行各种操作,例如添加、编辑、复制、删除、重命名和获取链接。

  1. 在 Web 门户中,打开“项目设置”。

    Screenshot showing project settings button.

    展开“版块”,然后选择“团队配置”。 如果需要切换到其他团队,请使用团队选择器。

  2. 选择“模板”

    可以选择任何工作项类型,以查看或添加该类型的模板。

通过团队设置管理模板。 所有模板都是为团队定义的。 如果你不是团队管理员,则添加为管理员。 只有团队或项目管理员可以更改工作项模板。

  1. 从 Web 门户中,打开团队的设置。

    选择 齿轮图标以打开团队的设置。

    此处我们打开 Web 团队的管理员页面。

    Screenshot of admin page.

  2. 选择“工作”>“模板”。

    Screenshot of Open Work - Templates page for team.

    在此处,可以选择任何工作项类型来查看或添加该类型的模板。

管理工作项类型的模板

选择“项目设置”>“团队配置”>“模板”。 用于查看其定义的模板的工作项类型。

例如,选择“用户情景”可查看定义用于捕获用户情景的模板。

Screenshot of User Story templates selection.

选择一个工作项类型,以查看其定义的模板。

例如,选择“用户情景”可查看定义用于捕获用户情景的模板。

Screenshot of managing user story templates.

创建工作项模板

  1. 从工作项类型页中,选择green plus icon新建模板”,从头开始创建模板。

    Screenshot showing adding a user story template.

  2. 为模板命名,并根据需要添加和删除字段。 完成后,保存模板。

  3. 若要获取模板的 URL,请选择“复制链接”。 可以使用此 URL 基于模板创建工作项。

在工作项类型页面中,选择现有模板的 操作图标以访问菜单选项以访问编辑删除复制链接创建副本的菜单选项。

Screenshot of Open template action menu.

  • 编辑:选择“编辑”并保存更改。
  • 删除:选择“删除”,然后再次从删除模板确认对话框中选择“删除”。 模板一旦删除,将无法恢复。
  • 复制链接:选择“复制链接”。 如果想添加使用其预定义值定义的类型的工作项,则可使用该 URL。 可以将 URL 保存为文本文件,将其作为超链接添加到网页,将链接复制到共享网络,或者通过电子邮件发送给团队。 此外,请考虑将链接添加到团队仪表板
  • 创建副本:选择“创建副本”。 为模板命名,根据需要添加和删除字段,然后在完成后保存它。

使用模板添加工作项

使用模板添加工作项的主要方法是在浏览器窗口中打开模板链接。 若要获取模板链接,请参阅编辑、删除、复制链接、创建副本部分。

将模板应用于新的或现有的工作项

可以将模板应用于单个工作项,也可以对多个工作项执行批量更新。

在工作项中应用模板

  1. 使用模板中定义的字段打开要更新的新工作项或现有工作项,选择 操作图标以打开菜单,选择“模板”,然后选择预定义模板的名称。

    Screenshot of Apply a template to an existing work item within the form.

    仅显示为你所属的团队定义的模板。

    提示

    刷新浏览器以发现添加的最新模板。 如果你没有看到任何模板,则可能没有适合该工作项类型的模板。

  2. 保存工作项,应用更改。 “历史记录”字段中注明了更改的字段。

在工作项中应用模板

  1. 使用模板中定义的字段打开要更新的工作项,选择 操作图标以打开菜单,选择“模板”,然后选择预定义模板的名称。

    Screenshot of Apply a template to an existing work item within the form.

    提示

    刷新浏览器以发现已添加的最新模板。 如果看不到任何模板,可能是没有为工作项类型定义模板。

  2. 保存工作项,应用更改。 “历史记录”字段中注明了更改的字段。

将模板应用于多个工作项

  1. 若要批量更新多个工作项,请先从积压工作或查询结果列表中选择这些工作项,然后打开其中一个工作项的操作菜单。 你选择的所有工作项必须具有相同的工作项类型。 例如,所有用户情景或所有 bug。

  2. 选择要应用的模板。

    Screenshot of Bulk update several work items.

  3. 将自动应用字段更改并保存工作项。 若要了解有关批量更新的详细信息,请参阅批量修改工作项

  1. 若要批量更新多个工作项,请先从积压工作或查询结果列表中选择这些工作项,然后打开其中一个工作项的操作菜单。 你选择的所有工作项必须具有相同的工作项类型。 例如,所有用户情景或所有 bug。

  2. 选择要应用的模板。

    Screenshot of Bulk updating several work items.

  3. 将自动应用字段更改并保存工作项。 若要了解有关批量更新的详细信息,请参阅批量修改工作项

在模板中添加或删除标记

可以将标记添加到模板,使用模板时,标记将应用于工作项。 若要添加两个或多个标记,请使用逗号 (,) 分隔标记。

Edit bug template, add or remove tags

如果未指定要删除的标记,则工作项中存在的所有标记都将保持定义状态。 即使将工作项模板应用于现有工作项,它们也会保持定义状态。

可以使用以下语法指定用于指定多个字段值的工作项模板。 如果想添加使用其预定义值定义的类型的工作项,则可使用该 URL。

https://dev.azure.com/{OrganizationName}/{ProjectName}/_workItems/create/{WorkItemType}?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .
http://{ServerName}:8080/tfs/DefaultCollection/{ProjectName}/_workItems/create/{WorkItemType}?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

例如,以下语法指定标题为“TaskTitle”的工作项任务。 它指定“分配到”、“说明”、“标记”、“活动”和“迭代路径”字段的值。

https://dev.azure.com/{OrganizationName}/{ProjectName}/_workItems/create/Task?
[System.Title]=TaskTitle&
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1
http://{ServerName}:8080/tfs/DefaultCollection/{ProjectName}/_workItems/create/Task?
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

提示

某些浏览器客户端施加了 2000 个字符的限制。

你可以将此 URL 另存为文本文件,或将 URL 以超链接形式添加到仪表板或网页。

可以向 Web 门户中的团队仪表板上显示的 Markdown 小组件添加链接。 这些链接打开一个工作项,其中预定义了模板定义字段。

例如,以下小组件包含指向三个模板的链接。

Markdown widget with links to templates

若要了解有关 Markdown 小组件的详细信息,请参阅将 Markdown 添加到仪表板、Markdown 小组件