在本章节中：

前言

Parasoft 任务插件旨在用于测试执行后的构建步骤，该步骤将 Parasoft 工具生成的功能和单元测试报告集成到 Team City 项目中。该任务将从 Parasoft report XML 文件收集测试结果，并显示通过/失败测试的数量和结果细节。还可以将结果显示为图中的趋势数据，以便进行简单的可视化。

该插件使用以下报告类型：

• Parasoft SOAtest 9.x XML 报告。
• 由 Parasoft C/C++test、Jtest 和 dotTEST 工具生成的 Parasoft Analyzers 10.x XML 报告。

要求

• TeamCity 2017.1.2 或更高版本

安装 Parasoft 任务插件

1. 将 zip 插件包复制到 /plugins 目录中。
2. 重启 TeamCity 服务。

查阅 TeamCity Installing Additional Plugins 文档页，以获得更多信息。

配置插件

1. 在构建配置页面，选择 Build Steps ，然后单击 Add build step。
2. 从 Runner type 下拉菜单中选择 Parasoft Findings 。
3. 指定步骤名称（可选），并从“执行步骤”下拉菜单中选择“执行步骤策略”（有关更多详情，请参阅 TeamCity documentation ）。
4. 在 Parasoft 配置部分选择报告类型：
   
   
5. 查看 Report location pattern 字段。此脚本中的 Ant 样式文件选择模式控制要在 TeamCity 构建报告中包含哪些 Parasoft XML 报告文件。
6. 完成后单击 Save 。

运行构建

典型的构建配置包括以下步骤：

1. 清除构建检出目录。在此步骤中，您将清理上次构建运行遗留下来的 Parasoft XML 报告文件。您可以配置以下选项：
   • 在构建配置的 Version Control Settings 中，在构建标志之前设置 checkout 目录中的 Clean all files 。
   • 配置一个命令行运行器来清理前几次运行遗留下来的 Parasoft XML 报告文件。例如，您可以运行以下命令从 build Checkout 目录中删除所有 XML 文件：
     
     rm %system.teamcity.build.checkoutDir%/*.xml
   • 配置生成代理以在生成完成后删除构建 Checkout Directory。为此，向 buildAgent.properties 文件添加以下行：
     
     teamcity.agent.build.checkoutDir.expireHours=0
     
     更多细节请参见下面的 TeamCity 文档：Automatic Checkout Directory Cleaning.
2. 运行 SOAtest、C/C++test、Jtest 或 dotTEST。此步骤将生成 XML 格式的报告文件。XML 报告文件必须保存在 TeamCity 构建项目签出目录中。
3. 运行 Parasoft 任务插件。您可以运行多个 Parasoft 工具，在调用此构建步骤之前生成多个 XML 报告文件。如果在 Parasoft 任务插件构建步骤之前的构建步骤生成多个 XML 报告文件，那么所有这些文件的所有测试结果都将添加到 TeamCity 构建结果中。

查看上次构建的结果

打开 TeamCity 构建配置页面，并单击 Overview 或 History 选项卡中的最后一个构建结果链接。构建结果页面包含适当的 Parasoft 工具报告详细信息。

• Overview 选项卡中的构建结果页面提供了成功和错误计数，以及错误细节。
• 在 Tests 选项卡中显示的构建结果包含在构建中运行的所有 Parasoft 测试的列表。
• Build Log 选项卡包含日志信息，以防需要调试。

查看统计数据和趋势

1. 单击构建配置页面的 Statistics 选项卡，查看由 Parasoft 工具生成的报告的历史数据图表。
2. 若要查看特定 Parasoft 测试的历史详细信息，请单击感兴趣测试旁边的菜单图标，并选择 Test History。将打开一个包含详细测试历史记录的页面。

更改日志