使用工作项模板

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

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

工作项模板可帮助你快速创建包含常用字段预填充值的工作项。 可以使用工作项模板来创建工作项或对多个工作项进行批量更新。 本文介绍如何从 Web 门户或 Visual Studio 2015 或更早版本添加和管理工作项模板。 有关演示如何使用工作项模板的示例,请参阅 示例工作项模板

工作项模板不同于流程模板。 有关详细信息,请参阅关于进程和流程模板或默认进程模板的这些特定文章:基本敏捷Scrum功能成熟度模型集成(CMMI)。

先决条件

先决条件 Description
权限 - 若要在 Web 门户中管理工作项模板,请成为拥有模板的团队的成员。 然后,可以根据需要添加、编辑或删除模板。
- 若要在 Web 门户中使用工作项模板,请成为项目的 参与者 。 然后,可以将模板应用于现有工作项。
工具 - 若要使用 Visual Studio Team Explorer 添加、捕获或编辑工作项模板,请安装 Microsoft Visual Studio Team Foundation Server 2015 Power Tools。 这些模板仅显示在团队资源管理器的视图中。

支持的模板任务

模板任务选项的可用性取决于客户端和平台配置。 可以从 Web 门户或 Visual Studio 2015 或更低版本添加和管理工作项模板。

下表显示了对 Web 门户和 Visual Studio 2015 或更低版本中任务的支持。 如果使用 “任务 说明”链接跳转到相应的部分,请确保根据需要在平台配置的部分中选择内容版本(选项卡)。

模板任务 Web 门户 Visual Studio
将工作项捕获为模板 ✔️ ✔️
管理工作项模板
(定义、编辑、删除、复制链接、创建副本和重命名)
✔️ ✔️
复制模板的链接(URL) ✔️ ✔️
使用模板添加工作项 ✔️ ✔️
定义工作项模板 ✔️ ✔️
将模板应用于一个或多个工作项 ✔️ ✔️
在模板中添加或删除标记 ✔️
使用超链接定义模板 ✔️

使用模板的限制

在 Web 门户中定义的模板不同于通过 Visual Studio 定义的模板。

  • 只能通过 Web 门户管理 Web 门户模板并将其应用于工作项。
  • Visual Studio 模板只能管理、查看和应用于 Visual Studio 中的工作项。

但是,可以使用这两种模板类型的 URL 通过 Web 门户添加工作项。

将工作项捕获为模板

根据所使用的平台、版本和客户端,可能需要执行不同的步骤来捕获工作项。 以下部分提供 Web 门户和 Visual Studio 2015 及更低版本的过程。

Azure DevOps 将唯一 GUID 标识符分配给通过 Web 门户捕获的每个模板。 使用以下过程通过 Web 门户将工作项捕获为模板,并访问已保存模板的链接:

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

  2. 在右侧,选择“ 更多作>模板>捕获”:

    显示如何从“更多作”菜单中选择“捕获工作项字段定义”作为模板选项的屏幕截图。

  3. “捕获模板 ”对话框中,配置必填字段和任何可选字段:

    • 团队:(必需)使用下拉列表选择要与捕获的模板关联的现有团队。

    • 名称:(必需) 输入模板的名称。

    • 字段:使用 “添加 ”作添加字段、 删除 作删除字段,并根据需要调整任何特定的字段

    • 备注:在框中选择以添加有关模板的详细信息。 在框中选择时,编辑工具会显示。 从捕获的模板创建新的工作项时,信息将添加为 讨论 线程中的第一个条目。

    显示如何在 Web 门户中的“捕获模板”对话框中配置字段的屏幕截图。

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

    如果想添加使用其预定义值定义的相同类型的工作项,则可使用该 URL。 下面是一些示例:

    • 通过在浏览器窗口中粘贴 URL 链接,基于捕获的模板创建工作项。
    • 添加工作项时,与他人共享 URL 供自己使用。
    • 将 URL 添加为指向 项目 Wiki 的超链接。
    • 将 URL 添加到 团队仪表板上的 Markdown 小组件

管理工作项模板

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

使用以下过程通过 Web 门户访问工作项模板:

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

  2. 在“ Boards ”部分中,选择 “团队配置”。 如果需要切换到其他团队,请在页面的痕迹导航跟踪中使用 团队 选择器。

  3. “版块 ”页中,选择 “模板” 部分:

    显示如何从项目设置、Boards、团队配置、模板访问 Azure DevOps 中保存的模板列表的屏幕截图。

  4. 选择工作项类型,例如 Bug功能测试用例 ,以查看或添加该类型的模板:

    为 Bug 工作项类型定义的模板的屏幕截图。

创建工作项模板

使用以下过程通过 Web 门户创建工作项模板:

  1. 在工作项类型页中,选择“ 新建模板 ”以从头开始创建模板:

    显示如何为 Bug 工作项类型添加新模板的屏幕截图。

    注释

    如果计划在大型文本字段中使用 Markdown,可以添加 <br> 标记来管理换行符,并确保 markdown 正确呈现。

  2. “新建模板 ”对话框中,输入模板 的名称 (必需),并根据需要添加具有任何必要值的字段。

  3. 选择“保存”“复制链接”选项变为可用。 可以使用此 URL 基于模板创建工作项。

保存模板后,可以编辑或删除模板、创建模板的可共享链接或创建模板的副本。

在工作项类型页中,为现有模板选择 “更多作 ”,然后选择菜单选项:

所选模板的“更多作”菜单选项的屏幕截图。

  • 编辑:若要更新模板,请选择“ 编辑”,进行更改,然后选择“ 保存”。

  • 删除:若要删除模板,请选择“ 删除”。 在确认对话框中,选择“ 删除”。 删除模板后,无法恢复它。

  • 复制链接:若要获取模板 URL 的副本,请选择 “复制”链接。 如果想添加使用其预定义值定义的相同类型的工作项,则可使用该 URL。 可以将 URL 保存为文本文件,将其作为超链接添加到网页,将链接复制到共享网络,或者通过电子邮件将其发送到团队。 此外,请考虑将链接添加到团队仪表板

  • 创建副本:若要创建模板的副本,请选择“ 创建副本”。 输入模板副本的名称,并根据需要添加、删除和更新字段。 完成后,选择“ 保存 ”。

使用模板添加工作项

使用模板添加工作项的最常见方法是在浏览器窗口中打开模板链接。

  1. 若要获取模板链接,请参阅编辑、删除、复制链接、创建副本部分。

  2. 若要创建新的工作项,请将模板链接粘贴到浏览器窗口中,配置必填字段,并保存所做的更改。

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

可以将模板应用于新的或现有的工作项,或者对多个现有工作项进行批量更新。

在 Web 门户中,可以在打开的工作项或所选工作项中应用模板。

在工作项中应用模板

使用以下过程将模板应用于新的或现有的工作项:

  1. 使用模板中定义的字段打开新的工作项或要更新的现有工作项。

  2. 选择 “更多作>模板”,然后选择预定义模板的名称:

    显示如何将模板应用于表单中现有工作项的屏幕截图。

    注释

    模板” 列表显示为所属团队定义的模板。 如果列表为空,则工作项类型可能没有任何模板。 刷新浏览器以发现最新的可用模板。

  3. 选择 “保存” 以应用所选模板。 工作项 “历史记录 ”字段中记录了任何字段更改。

将模板应用于多个工作项

使用以下过程将模板应用于批量更新的选定工作项:

  1. 积压工作项查询 结果列表中选择工作项。 选择的所有工作项都必须具有相同的工作项类型,例如 Bug功能

  2. 为所选工作项之一选择 “更多作>模板 ”,然后选择要应用的模板。

    显示如何将模板应用于多个工作项的批量更新的屏幕截图。

将自动应用字段更改,并保存工作项。 工作项 “历史记录 ”字段中记录了任何字段更改。 有关批量更新的详细信息,请参阅 批量修改工作项

在模板中添加或删除标记

在 Visual Studio 2015 或更早版本中,可以将标记添加到模板,并在使用模板时将其应用于工作项。 若要添加两个或多个标记,请用逗号(,)分隔它们。 此任务在 Web 门户中不可用。

显示如何添加或删除标记的“编辑模板”对话框的屏幕截图。

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

在 Visual Studio 2015 或更早版本中,可以使用以下语法指定定义多个字段值的工作项模板。 每当要添加具有相同类型的工作项和预定义值时,都可以使用该 URL。 此任务在 Web 门户中不可用。

https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

例如,以下代码使用 TitleTaskTitle 指定工作项任务。 语法指定“已分配给”、“说明”、“标记”、“活动”和“迭代路径”字段的值。

https://dev.azure.com/<Organization_Name>/<Project_Name>/_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://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_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

注释

某些浏览器客户端对字段值施加 2,000 个字符的限制。

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

可以在 Web 门户中的团队仪表板上添加指向 Markdown 小组件的链接。 这些链接使用预定义的模板定义字段打开工作项。

以下示例显示了一个包含指向三个模板的链接的小组件:

Markdown 小组件的屏幕截图,其中包含指向模板的链接。

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