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 门户将工作项捕获为模板,并访问已保存模板的链接:
从 Web 门户中,打开要用作模板基础的工作项。
在右侧,选择“
更多作>模板>捕获”:在 “捕获模板 ”对话框中,配置必填字段和任何可选字段:
团队:(必需)使用下拉列表选择要与捕获的模板关联的现有团队。
名称:(必需) 输入模板的名称。
字段:使用
“添加 ”作添加字段、
删除 作删除字段,并根据需要调整任何特定的字段 值 。备注:在框中选择以添加有关模板的详细信息。 在框中选择时,编辑工具会显示。 从捕获的模板创建新的工作项时,信息将添加为 讨论 线程中的第一个条目。
选择“ 保存”,然后选择“ 复制”链接 以捕获模板的 URL。
如果想添加使用其预定义值定义的相同类型的工作项,则可使用该 URL。 下面是一些示例:
- 通过在浏览器窗口中粘贴 URL 链接,基于捕获的模板创建工作项。
- 添加工作项时,与他人共享 URL 供自己使用。
- 将 URL 添加为指向 项目 Wiki 的超链接。
- 将 URL 添加到 团队仪表板上的 Markdown 小组件。
管理工作项模板
对于每个工作项类型,可以查看和管理团队定义的模板。 对模板执行各种作,例如添加、编辑、复制、删除或重命名,并获取模板的链接。
使用以下过程通过 Web 门户访问工作项模板:
在 Web 门户中,打开“项目设置”。
在“ Boards ”部分中,选择 “团队配置”。 如果需要切换到其他团队,请在页面的痕迹导航跟踪中使用 团队 选择器。
在 “版块 ”页中,选择 “模板” 部分:
选择工作项类型,例如 Bug、 功能或 测试用例 ,以查看或添加该类型的模板:
创建工作项模板
使用以下过程通过 Web 门户创建工作项模板:
在工作项类型页中,选择“
新建模板 ”以从头开始创建模板:
注释
如果计划在大型文本字段中使用 Markdown,可以添加
<br>标记来管理换行符,并确保 markdown 正确呈现。在 “新建模板 ”对话框中,输入模板 的名称 (必需),并根据需要添加具有任何必要值的字段。
选择“保存”。 “复制链接”选项变为可用。 可以使用此 URL 基于模板创建工作项。
编辑、删除、复制链接或创建副本
保存模板后,可以编辑或删除模板、创建模板的可共享链接或创建模板的副本。
在工作项类型页中,为现有模板选择
“更多作 ”,然后选择菜单选项:
编辑:若要更新模板,请选择“ 编辑”,进行更改,然后选择“ 保存”。
删除:若要删除模板,请选择“ 删除”。 在确认对话框中,选择“ 删除”。 删除模板后,无法恢复它。
复制链接:若要获取模板 URL 的副本,请选择 “复制”链接。 如果想添加使用其预定义值定义的相同类型的工作项,则可使用该 URL。 可以将 URL 保存为文本文件,将其作为超链接添加到网页,将链接复制到共享网络,或者通过电子邮件将其发送到团队。 此外,请考虑将链接添加到团队仪表板。
创建副本:若要创建模板的副本,请选择“ 创建副本”。 输入模板副本的名称,并根据需要添加、删除和更新字段。 完成后,选择“ 保存 ”。
使用模板添加工作项
使用模板添加工作项的最常见方法是在浏览器窗口中打开模板链接。
若要获取模板链接,请参阅编辑、删除、复制链接、创建副本部分。
若要创建新的工作项,请将模板链接粘贴到浏览器窗口中,配置必填字段,并保存所做的更改。
将模板应用于新的或现有的工作项
可以将模板应用于新的或现有的工作项,或者对多个现有工作项进行批量更新。
在 Web 门户中,可以在打开的工作项或所选工作项中应用模板。
在工作项中应用模板
使用以下过程将模板应用于新的或现有的工作项:
使用模板中定义的字段打开新的工作项或要更新的现有工作项。
选择
“更多作>模板”,然后选择预定义模板的名称:
注释
“ 模板” 列表显示为所属团队定义的模板。 如果列表为空,则工作项类型可能没有任何模板。 刷新浏览器以发现最新的可用模板。
选择 “保存” 以应用所选模板。 工作项 “历史记录 ”字段中记录了任何字段更改。
将模板应用于多个工作项
使用以下过程将模板应用于批量更新的选定工作项:
从 积压工作项 或 查询 结果列表中选择工作项。 选择的所有工作项都必须具有相同的工作项类型,例如 Bug 或 功能。
为所选工作项之一选择
“更多作>模板 ”,然后选择要应用的模板。
将自动应用字段更改,并保存工作项。 工作项 “历史记录 ”字段中记录了任何字段更改。 有关批量更新的详细信息,请参阅 批量修改工作项。
在模板中添加或删除标记
在 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 小组件。