处理模板和插件文件

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

通过自定义一个或多个进程模板文件来自定义项目的初始配置。 您可自定义多种类型的模板文件,这些文件包括根 XML 文件、插件文件和 XML 定义文件。 通过自定义这些文件,可以定义从进程模板创建的所有项目的初始配置。

有关默认进程模板的信息,请参阅 “选择进程”。 若要了解如何自定义进程模板,请参阅 “自定义进程模板”。

客户端对项目创建的支持

根据你是否从 Azure DevOps Services 或 TFS 工作,可以从 Web 门户或 Visual Studio/Team Explorer 创建项目。

客户端 Azure DevOps Services TFS 2018 和 TFS 2017 TFS 2015 及更低版本
Web 门户 ✔️ ✔️
Visual Studio/Team Explorer ✔️ ✔️

✔️ (- 支持; ❌ - 不支持)

从 Web 门户创建项目时,将忽略以下插件文件。

  • 生成:为生成函数定义默认安全权限。
  • 实验室管理:本机生成和发布管理工具取代了以前的实验室管理工具。 若要了解详细信息,请参阅 使用生成和发布而不是实验室管理进行自动测试
  • 报表:在创建项目后,请参阅 向项目添加报表 以添加 SQL 报表。
  • 版本控制:为 git 和 TFVC 函数定义默认安全权限和 TFVC 签入策略。
  • Windows SharePoint Services:TFS 2018 及更高版本不再支持与 SharePoint 产品的本机集成。 请参阅 “关于 SharePoint 集成 ”,了解可用的选项。 对于 TFS 2017 和更早版本,必须使用 Visual Studio/Team Explorer 添加 SharePoint 集成。
  • 自定义插件:不支持。

有关详细信息,请查看 插件文件说明和 PCW 支持

根过程模板文件

自定义根 XML 文件 ProcessTemplate.xml 可以定义要处理的插件文件的序列和每个插件的依赖项。 ProcessTemplate.xml文件包含必须运行才能成功创建项目的所有任务组。 每个任务组引用一个用于定义特定任务的从属 XML 插件文件(通常位于子文件夹中)。 有关详细信息,请参阅 定义根任务

插件文件说明和 PCW 支持

每个插件文件通过定义一个或多个任务来配置特定的功能区域。 任务指定上传文件、设置组的权限或配置其他一些功能区域。 例如,工作项跟踪插件配置项目的工作项类型、查询、类别和进程配置。

下表介绍了每个插件文件,以及从 Visual Studio/Team Explorer 或 Web 门户创建项目时是否受支持。调用插件的顺序由根进程模板文件确定。 还可以删除过程模板中的插件,但分类插件除外。

✔️ (- 支持; ❌ - 不支持)

插件文件夹和文件

客户端

Web 门户

说明

生成
Build.xml

✔️

定义 Team Foundation Build 使用的初始安全权限并上传生成模板文件。

对于 Azure DevOps Services 和 TFS 2017.3 及更高版本,此插件将被忽略,并且仅定义默认权限。

✔️

✔️

配置初始区域和迭代或冲刺路径。 此外,上传 Microsoft 项目映射 (FileMapping.xml) 文件 ,该文件定义工作跟踪字段如何映射到 Office Project 字段。

✔️

✔️

定义初始安全组、团队、团队成员及其权限。

Lab Management
Lab.xml

✔️

定义分配给 Visual Studio 实验室管理标识的初始安全权限。

对于 Azure DevOps Services 和 TFS 2017.3 及更高版本,此插件将被忽略,并且仅定义默认权限。 今后,本机生成和发布管理工具将取代以前的实验室管理工具。 若要了解详细信息,请参阅 使用生成和发布管理而不是实验室管理进行自动化测试

✔️

为项目创建报表管理器站点并上传 Reporting Services 报表。 仅支持本地 TFS。

对于 TFS 2017.3 及更高版本,只能通过 Web 门户创建项目,该门户忽略此插件。 若要在创建项目后添加报表,请参阅 向项目添加报表

测试管理
TestManagement.xml

✔️

✔️

定义项目的初始测试变量、配置、设置和解析状态。 此插件还会上传以下文件中包含的信息:

  • localrun.testsettings:定义本地测试运行的默认测试设置。
  • testconfiguration:配置为项目定义的 (硬件和软件) 的默认测试配置。 创建项目之后,可以删除这些配置并创建其他配置。
  • testresolutionstate:定义测试运行程序、Microsoft 测试管理器和 Web 门户 测试 页所使用的测试解析状态。 创建项目后,无法更改这些状态。 若要在为本地 TFS 创建项目后更改解析状态,请参阅 “自定义和管理测试体验”。
  • testsettings:指定初始测试设置文件。 只指定一个文件,即 localrun.testsettings。
  • testvariable:定义初始测试变量。 创建项目之后,可以修改这些变量并创建其他变量。

版本控制
VersionControl.xml

✔️

定义 Git 和 Team Foundation 版本控制的初始安全权限, (TFVC) ,以及 TFVC、签入说明以及是否需要独占签出。

对于 Azure DevOps Services 和 TFS 2017.3 及更高版本,此插件将被忽略,并且仅定义默认设置和权限。 创建项目后,可以从 Web 门户管理 TFVC 签入策略权限

Windows SharePoint Services
WssTasks.xml

✔️

基于 SharePoint 网站的模板定义项目门户。 仅支持本地 TFS。

TFS 2018 及更高版本不再支持与 SharePoint 产品的本机集成。 如果打算升级到 TFS 2018,请阅读 “关于 SharePoint 集成 ”,了解可用的选项。 对于 TFS 2017 及更早版本,必须使用 Visual Studio/Team Explorer 添加 SharePoint 集成。 或者,若要在创建项目后添加项目门户网站,请参阅 “配置”或“添加项目门户”。 从 Web 门户创建项目将忽略WssTasks.xml插件。

此插件还会上传以下文件和文件夹中包含的信息:

  • 流程指南:上传一组.htm文件,其中包含当用户单击 ProcessGuidance WI Icon 工作项窗体客户端版本的帮助图标时打开进程指南主题的 URL。 可以对这些文件进行自定义,使其指向过程指南的其他资源。
  • 示例和模板:上传一个或多个 Excel 工作簿 (.xlsx 文件) 以支持 bug 会审和跟踪问题。
  • 共享文档:上传一个或多个示例文档和模板文件作为创建工作产品的起点。

进程模板文件不包括仪表板或 Microsoft Excel 报表。 这些文件将添加到项目中,具体取决于创建项目时所做的选择。 如果没有为项目预配 SharePoint 网站,则没有可用的仪表板或 Office Excel 报表。 有关这些项目的详细信息,请参阅以下主题: 项目门户仪表板Excel 报表 (敏捷) Excel 报表 (CMMI)

工作项跟踪
WorkItems.xml

✔️

✔️

定义项目的初始工作项类型、查询和工作项实例。 团队成员使用“工作项”来跟踪工作。 工作项类型定义用于跟踪工作的字段、工作流和表单。 若要在创建项目后自定义其中的任何对象,请参阅 “自定义工作跟踪体验”。

此插件还会上传以下文件和文件夹中包含的信息:

  • Categories.xml:定义用于对工作项类型进行分组的类别的 XML 定义文件。
  • LinkTypes
  • SharedParameterLink.xml:定义支持将共享参数链接到测试用例的链接类型。
  • SharedSteps:定义支持将共享步骤链接到测试用例的链接类型。
  • TestBy:定义支持将测试用例链接到工作项(如产品积压工作项、用户情景、要求和 bug)的链接类型。

可以根据流程模板定义其他链接类型。 有关所有链接类型的说明,请参阅 链接工作项以支持可跟踪性和管理依赖项

  • 过程:定义 ProcessConfiguration.xml文件 ,该文件指定敏捷工具积压工作和板的默认配置。
  • 查询:定义多个工作项查询 (定义为查询文件夹中的 .wiq 文件) 。
  • TypeDefinitions:定义 TypeDefinition 文件夹中包含的 15 个或多个工作项类型 XML 定义文件。 定义因所选的进程模板而异。
  • 工作项:定义一个或多个工作项。 默认进程模板中未定义任何定义。

对于 Azure DevOps Services 和 TFS 2017.3 及更高版本,创建项目时将忽略工作项实例的定义。

过程模板的架构定义将使用 Camel 大小写格式和所有大写元素的组合。 如果在验证类型定义文件时遇到错误,请检查元素的大小写结构。 同时,根据 XML 语法规则,开始标记与结束标记的大小写结构还必须匹配。 请参阅 进程模板插件:索引到 XML 元素定义