您可以在 GUI 或命令行界面中配置报告设置（使用设置）。除了生成本地报告，您还可以将报告发送到 Parasoft DTP。向 DTP 发送报告使您能够应用复杂的分析来更好地理解与被测应用程序以及您的总体开发和测试流程相关的风险。

章节目录：

在 GUI 中

您可以使用 GUI 控件为所有测试指定报告设置（无论它们是从命令行界面还是 GUI 运行的）。配置报表设置之前，应该检查以下首选项页面上的设置，以确保正确计算了任务作者、将结果发送到适当的系统、使用了正确的电子邮件主机，等等：

用户界面中指定的设置可以被通过设置指定的设置完全或部分覆盖。

若要从 GUI 中指定报告设置，请完成以下内容：

  1. 选择 Parasoft> 首选项。将打开一个首选项对话框。
  2. 选择 Parasoft> 报告。
  3. 指定合适的设置。可用的设置在下面的Report Configuration Settings有所说明。
  4. 如果还没有在 GUI 或命令行中配置电子邮件设置（发送者地址、主机名等），请在 Parasoft> E-mail 中配置。
  5. 选择 Parasoft> 报告> E-mail 通知。
  6. 指定合适的电子邮件通知设置。可用设置包括：
    • 通过电子邮件发送报告：指定是否通过电子邮件发送报告。
    • 电子邮件主题：指定包含报告的电子邮件的主题。指定邮件发送的主题行。默认主题行为 "[Product Name] Report."例如，如果想要将主题行更改为 "Functional Testing Report for Project A"，那么可以输入 Functional Report for Project A
    • 发送管理者的报告至：指定发送管理器报告的位置。您可以输入单个地址或分号分隔的列表。
    • 发送没有任务的报告：指定在报告零任务时是否发送报告。您可以输入单个地址或分号分隔的列表。
    • 发送开发者的报告至：指定发送开发人员报告的位置。您可以输入单个地址或分号分隔的列表。
    • 发送 ‘未知’ 开发者的报告至：指定将分配给“未知”的任务（无法追溯到特定开发人员的任务）的开发人员报告发送到何处。这些报告只能发送到一个用户/地址。用分号分隔的地址列表无效。

报告配置设置

报告内容

设置说明
为开发者提供详细报告确定是否为每个团队成员生成自定义的详细报告（除了为管理人员生成摘要报告之外）。这些报告只包含分配给特定团队成员的任务。
按作者分配的任务概述确定报告是否包含分配给每个开发人员的任务数量及类型的概述。
已检查文件和执行测试的概述

指定报告是否提供有关所有已检查文件和已执行测试的详细信息。 

对于静态分析，这将生成一个已检查的所有文件的列表。对于每个文件，它列出规则违规的数量。如果文件有违规行为，它还列出了违规的行号、规则名和规则 ID。

对于测试执行，这将产生一个所有已执行测试用例及其结果（通过或失败）的列表。对于每个测试套件，它列出了测试用例的总数和通过测试用例的数量。如果为测试用例报告了一个任务，就会显示额外的细节（堆栈跟踪、结果等）。

对于代码评审，这将导致一个包含 author - reviewer - monitor 之间消息的所有未决问题的列表（默认情况下由会话标记过滤）。

任务细节确定报告是否包含所有报告任务的详细信息。
测试用例细节确定报告是否包含所有执行的测试用例的详细信息。
需求/缺陷细节

指定报告是否显示与测试相关联的需求、缺陷、任务和特征请求。

要使此设置生效，必须禁用只有顶层的测试套件（描述如下）。

只有顶层的测试套件确认测试套件汇总报告部分是只列出 .tst 文件（需要启用该选项），还是显示每个 .tst 文件中的树状视图（需要禁用该选项）。
启用的静态分析规则确定报告是否列出为测试启用的静态分析规则。
只有失败的测试指定报告是否只列出失败的测试。
在命令行模式下生成格式化报告确定是否为在命令行模式下运行的测试生成格式化报告。
趋势图的截止日期指定跟踪一段时间内不同任务类别的趋势图的开始日期。 

HTML 报告需求/缺陷详情的超链接

如果您正在为工件指定一个 URL（例如，作为一个 SOAtest 测试属性），该 URL 将在 HTML 报告中作为一个超链接可用。 

如果希望创建超链接，并且仅使用关联测试与开发工件中指定的工件 ID 指定工件关联性，那么您可以使用本地属性指定 ID 如何映射到 URL。

例如：

  • report.assoc.url.pr=https://bugzilla.parasoft.com/show_bug.cgi?id=[%ID%]
  • report.assoc.url.jira=https://jira.parasoft.com/browse/[%ID%]
  • report.assoc.url.fr=https://bugzilla.parasoft.com/show_bug.cgi?id=[%ID%]
  • report.assoc.url.task=http://dtp.parasoft.com.pl:8080/grs/jsf/planning/task/edit_task.jsf?entityId=[%ID%]

报告格式

设置说明
格式

指定所需报告格式：

  • HTML - 包括 XML 源数据文件
  • PDF
  • XML SATE - 格式特定于 NIST SAMATE 静态分析工具的说明
  • XSL 自定义
  • xUnit - 一种类似 JUnit 的格式，添加了嵌套测试套件。这种格式由 Jenkins、Hudson、Eclipse Junit 视图等支持。它只适用于启用 已检查文件和执行测试的概述。
    这种格式支持语言工具：dotTEST、C++test 和 Jtest。
XSL file如果选择自定义 XSL 作为报告格式，请指定定义您的自定义格式的 XSL 文件的路径。 
报告文件扩展名如果想使用一个文件扩展名而不是默认的 .html 扩展名，请在这里指定该扩展名。
生成包括整个报告内容的附加压缩包

启用此选项可在指定的报告位置生成附加压缩包（.zip）文件。ZIP 文件包含生成用于构建报告的所有文件。 

此选项可以为任何报告格式生成一个压缩包（如：HTML、CSV、PDF等等）。 

通过生成压缩包，还可以执行报告的自定义转换，因为所有元素都生成到指定目标文件夹。

高级设置

设置说明
为 XML 数据添加绝对文件路径指定是否将绝对文件路径添加到 XML 数据。如果希望在将任务导入到桌面安装时重新定位任务，则需要在服务器安装上启用此功能。（如在导入任务时重定位：要求和限制中所述）。 
会话标签会话标签是测试运行的唯一标识符，用于区分特定的运行和 DTP 中的类似运行。团队每次常规测试运行的结果都应该有一个唯一的标记。变量可以按照为命令行执行使用首选项设置中的说明来使用。例如，如果您的团队运行静态分析、单元测试和代码审查，那么您可能使用会话标签 Static、Execution 和 Code Review。或者，您可能使用类似 session.tag=${config_name} 或 session.tag=${analysis_type} 这样的变量
构建 ID

指定用于标记结果的构建标识符。对于每个构建，它可能是独一无二的，但也可能标记在指定的构建期间执行的多个测试会话。

默认为 ${dtp_project}-${time}。

在设置中

详情请参阅报告设置。 

旧版报告格式

注意

桌面安装程序通过 GUI 或命令行生成的默认报告存在一些限制。详情请参阅以下内容。

  • 在 2021.2 之前的版本中，默认的 XML/HTML 报告不会链接到为测试和开发工件之间的关联而单独配置的 URL。必须为每种关联类型定义 URL 模板，链接才能出现在报告中。要查看单独定义的 URL 链接，请按下文所述启用旧版报告格式。

这些限制可以通过启用旧版报告格式解决。要启用旧版报告格式，请将系统属性 parasoft.legacy.report.format 设置为 true。在桌面安装程序中，可以通过配置以下命令行参数来实现：-J-Dparasoft.legacy.report.format=true

支持自定义报告格式

您可以通过构建一个定制 XSL 转换器来定制本地生成的和通过电子邮件发送的报告，该 XSL 转换器指定您希望如何格式化结果。例如，您可以使用自定义转换器将数据映射到所需的格式，以演示对内部安全策略的遵从性。

若要指定自定义报告格式，您需要这样做：

  1. 创建一个 XSL 文件，指定要如何转换 XML 数据。
  2. 在首选项面板的报告页面中，指定这个 XSL 文件的位置，以及应该分配给结果文件的扩展名。

    • 或者，您可以通过
      (results.)report.custom.extension 和 (results.)report.custom.xsl.file 设置在设置文件中指定此信息。

可用参数

自定义 XSL 文件可以使用以下参数：

参数注意
report_type=disk_report|email_report确定生成的报告是通过电子邮件发送还是保存在本地磁盘驱动器上。 
test_params

用于启动生成此报告的产品的命令行。

示例：

soatestcli -config team://xtest-static.properties^
 -settings /home/nightly/settings.properties^
 -publish -report /home/nightly/reports/report.html^
 -resource myproject^
 -dtp.autoconfig [email protected]:8080
test_config_name

为生成此报告而执行的测试配置的名称。
例如：Parasoft 推荐的规则

output_dir=[dir]

创建报告的目录。这可以用来生成开发人员报告。

示例：

<xsl:value-of select="concat($output_dir,$dev_reports_prefix,$authid,'.csv')"/>

rules_dir_path=[path]

保存规则文档的目录。这可以用来生成规则弹出/链接。

示例：

<xsl:value-of select="concat('javascript:openWin(',$qt,$rules_dir_path,$id,'.html',$qt,')')"/> 

dev_errors=true|false“任务详情”选项的值。详情请参阅Report Configuration Settings。
dev_reports=true|false“为开发者提供详细报告”选项的值。详情请参阅Report Configuration Settings。
show_active_rules=true|false“启用的静态分析规则”选项的值。详情请参阅Report Configuration Settings。
associations=true|false“需求/缺陷细节”选项的值。详情请参阅Report Configuration Settings。
dev_reports_prefix=[prefix]

用于命名开发人员报告的前缀。

示例：

<xsl:value-of select="concat($output_dir,$dev_reports_prefix,$authid,'.csv')"/>

exec_cvg_details=true|false

“详细报告关于”选项的值。详情请参阅Report Configuration Settings。

attachments=true|false设置键 report.mail.attachments 的值。详情请参阅配置设置。
test_suites_only=true|false

设置键 report.test_suites_only 的值。详情请参阅配置设置。

test_cases_details=true|false“测试用例细节”选项的值。详情请参阅Report Configuration Settings。
failed_tests_only=true|false设置键 report.failed_tests_only 的值。详情请参阅配置设置。
authors_details=true|false“按作者分配的任务概述”选项的值。详情请参阅Report Configuration Settings。
contexts_details=true|false“已检查文件和执行测试的概述”选项的值。详情请参阅Report Configuration Settings。
  • No labels

Need assistance? Visit our support page