在本章节中：

前言

Jenkins 的 Parasoft 任务插件允许在 Jenkins 中可视化静态分析和测试结果。它将 Parasoft 产品生成的 XML 报告转换为趋势图，使您更方便地查看详情，或更轻松地导航到规则文档。该插件可以与 Freestyle、Maven 和 Pipeline 任务一起使用。

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

• Parasoft SOAtest 9.x 生成的功能测试报告。
• C/C++test 10.x 桌面版和 DTP 引擎 10.x（C/C++test、Jtest 和 dotTEST）生成的静态分析和单元测试报告。   

要求

• 使用此插件要求 Jenkins 1.625.1 或更高版本。
• 构建此插件要求 Java 7 JDK 和 Maven 3。

安装指南 

使用 Jenkins 插件 UI 最简单的安装方法：

1. 选择 Manage Jenkins> Manage Plugins> Available。
2. 定位并启用 Parasoft Findings Plugin for Jenkins。
3. 单击 Download now and install after restart。 

作为一种选择，可以从 Parasoft 的 GitHub 资源库中下载插件，根据指导说明将插件构建为 HPI 文件（Jenkins 的插件格式）： https://github.com/jenkinsci/parasoft-findings-plugin。创建 HPI 文件之后，可以通过 Jenkins web UI 或命令行部署插件。 

Web UI

1. 从 Jenkins 菜单选择 Manage Jenkins> Manage Plugins ，然后单击 Advanced 选项卡。
2. 在上传插件部分，单击 Choose File 并选择 parasoft-findings.hpi。
3. 单击 Upload。
4. 重启 Jenkins。

命令行

关于命令行的安装，请查阅 Jenkins documentation 。安装插件后重启 Jenkins。 

配置

可以将该插件与新的和现有的 Jenkins 任务一起使用。

发布静态分析结果

1. 启用 Publish Parasoft analysis results 选项。 
   • 对于 Maven 任务，则选择 Configure> Build Settings ，并启用 Publish Parasoft analysis results 选项。
     
     
     
     
   • 对于 Freestyle 任务： 
     1. 选择 Configure> Post-build Actions> Add post-build action
     2. 从下拉菜单中选择 Publish Parasoft analysis results 。 
        
        
        
        
2. 在 Settings 字段中指定 Parasoft 分析器使用的绝对路径或工作空间相对路径。此 settings 文件应该包含 report.location 属性，指定 report.xml 文件保存的位置。关于配置 settings 文件的其他信息，请查阅分析器的文档。

3. 也可以启用 Report location 选项，并指定在 File pattern 字段中 Parasoft 分析器生成的 report.xml 文件的工作空间相对路径。此设置覆盖上一步骤的 report.location 配置，这在 Jenkins 和 report.xml 文件的目录都在本机机器上时非常有用。

   C++test 10.x 桌面版报告设置

   C++test 10.x 桌面版的静态分析报告必须启用 Add absolute file paths to XML data 选项来生成。可以在 settings 文件中设置 report.location_details=true 属性，它允许在其没有保存在 Jenkins 工作空间时导航到源代码，以在命令行上启用此选项。

4. 在 settings 文件中配置对规则文档的访问。
   1. 连接到 DTP，通过以下属性访问线上文档： 
      • dtp.server 
      • dtp.port 
      • dtp.user 
      • dtp.password
   2. 关于本地文档，请将 report.rules 属性设置为包含分析器文档的目录。例如：
      report.rules=<engine-location>/rules/doc

发布 Freestyle 和 Maven 任务的测试执行结果 

1. 选择 Configure> Post-build Actions> Add post-build action。
2. 从下拉菜单中选择 Publish xUnit test result .
   
   
    
3. 单击 Add。
4. 选择 ParasoftAnalyzers-10.x 或 ParasoftSOAtest-9.x。
   
   
    

5. 在 Pattern 选项卡中指定 Parasoft 分析器生成 report.xml 文件的工作空间相对路径。

   C++test 10.x 桌面版单元测试结果

   C++test 10.x 桌面版的单元测试必须启用 Overview of checked files and executed tests 选项来生成。可以通过设置 settings 文件中的 report.contexts_details=true 属性在命令行上启用此选项。

发布 Pipeline 任务的发现结果

Jenkins Pipeline 是一套插件，支持实现和集成到 Jenkins 中的连续交付管道。关于管道的更多详情，请查阅 Jenkins documentation 。 

静态分析

若要使用管道任务发布静态分析结果，则将步骤添加到管道脚本以调用 Parasoft Findings publisher 类或使用符号名称：

step([$class: 'ParasoftPublisher', useReportPattern: true, reportPattern: '*.xml', settings: ''])

或
parasoftFindings useReportPattern: true, reportPattern: '*.xml', settings: ''

传递的参数对应于插件配置中可用的选项：

单元测试和功能测试

若要使用管道任务发布单元测试和功能测试，则添加步骤以调用 xUnit publisher 类并指定要发布的报告的正确类型：

ParasoftAnalyzers-10.x

step([$class: 'XUnitBuilder', tools: [[$class: 'ParasoftType', pattern: '']]])

ParasoftSOAtest-9.x

step([$class: 'XUnitBuilder', tools: [[$class: 'ParasoftSOAtest9xType', pattern: '']]])

查看静态分析任务

静态分析趋势图显示的结果由模块、规则类别或严重度组织。

可以在源代码中查看任务并导航至规则文档。

查看测试执行结果

测试执行趋势图显示测试状态、执行时间和测试失败的堆栈追踪。

更改日志