You can customize reports by configuring the settings in the .properties file (see Configuration Overview). This section describes examples of how your reports can be configured. See Report Settings for a complete list of settings that allow you to customize your reports to your needs.
| Table of Contents | ||
|---|---|---|
|
Specifying Report Output Location
You can configure the location of reports with the report.location property. For example:
| Code Block |
|---|
report.location=[path/to/location] |
Alternatively, you can specify the output directory for reports with the -report switch. For example:
| Code Block |
|---|
jtestcli -report [path/to/location] |
Ant and Maven Pattern
You can configure the location in Ant or Maven with the following pattern:
| Code Block |
|---|
<report>location</report> |
Specifying Report Format
By default, an HTML report is generated. You can generate a PDF report or a report with a custom extension to the specified directory by setting the report.format property. For example:
| Code Block |
|---|
report.format=pdf |
Support for Custom Report Formats
You can customize locally-generated and emailed reports by building a custom XSL transformer that specifies how you want the results formatted. For instance, you could use a custom transformer to map data into the format you need to demonstrate compliance to an internal security policy.
To specify a custom report format, you need to:
- Create an XSL file that specifies how you want to transform the XML data.
- Specify the location of the XSL file, as well as the extension that should be assigned to the resulting file by configuring the following settings in your .property file:
report.format=customreport.custom.xsl.file=<path to the XSL file>report.custom.extension=<extension of the resulting file>
If you perform analysis from your IDE, you can specify the the location of the XSL file and the extension of the resulting file on the Reports preference page; see Generating Reports.
Available Parameters
The following parameters can be used in custom XSL files:
| Parameter | Notes |
|---|---|
| report_type=disk_report|email_report | Determines if the generated report will be sent by email or saved on the local disk drive. |
| test_params | The command line that was used to start the product that generated this report. Example: jtestcli: -config dtp://xtest-static.properties -localsettings /home/nightly/localsettings.properties -publish -report /home/nightly/reports/report.html -resource myproject -dtp.autoconfig [email protected]:8080 |
| test_config_name | The name of the test configuration that was executed to produce this report. |
| output_dir=[dir] | The directory where the report is created. This can be used to generate developer reports. Example: <xsl:value-of select="concat($output_dir,$dev_reports_prefix,$authid,'.csv')"/> |
| rules_dir_path=[path] | The directory where rules documentation is saved. This can be used to generate rule popups/links. Example: <xsl:value-of select="concat('javascript:openWin(',$qt,$rules_dir_path,$id,'.html',$qt,')')"/> |
| suppr_msgs=true|false | The value of the report.suppressed_msgs option. See Report Settings details. |
| dev_errors=true|false | The value of the report.developer_errors option. See Report Settings details. |
| dev_reports=true|false | The value of the report.developer_reports option. See Report Settings details. |
| show_active_rules=true|false | The value of the report.active_rules option. See Report Settings details. |
| associations=true|false | The value of the report.associations option. See Report Settings details. |
| dev_reports_prefix=[prefix] | The prefix used to name developer reports. Example: <xsl:value-of select="concat($output_dir,$dev_reports_prefix,$authid,'.csv')"/> |
| attachments=true|false | The value of the report.mail.attachments option. See Report Settings details. |
| authors_details=true|false | The value of the report.authors_details option. See Report Settings details. |
| contexts_details=true|false | The value of the report.contexts_details option. See Report Settings details. |