...
Before configuring report settings, you should review the settings on the following preference pages to ensure that the task authorship is being calculated correctly, results are being sent to the proper Team Server and Parasoft Report Project Center server, the correct email host is used, and so on:
- Development Testing Platform
- Report Center / Project Center\
- License
- Scope and Authorship
- Source Control
- Team Server
...
| Setting | Description |
|---|---|
| Detailed report for developers | Determines whether customized, detailed reports are generated for each team member (in addition to a summary report for managers). These reports contain only the tasks assigned to that specific team member. |
| Overview of tasks by authors | Determines whether the report includes an overview of the number and type of tasks assigned to each developer. |
| Overview of checked files and executed tests | Specifies whether the report provides details about all checked files and executed tests. For static analysis, this results in a list of all the files that were checked. For each file, it lists the number of rule violations and the number of suppressed violations. If the file has a violation, it also lists the line number, rule name, and rule ID for that violation. For test execution, this results in a list of all executed test cases and their outcomes (pass or fail). For each test suite, it lists the total number of test cases and the number of passed test cases. If a task is reported for a test case, additional details (stack trace, outcome, etc.) are presented. For code review, this results in a list of all pending issues with messages between author - reviewer - monitor (filtered by session tag by default). |
| Task details | Determines whether the report includes details about all of the reported tasks. |
| Test case details | Determines whether the report includes details about all executed test cases. |
| Suppression details | Specifies whether the report lists suppressed messages. |
| Requirement/defect details | Specifies whether the report shows requirements, defects, tasks, and feature requests that are associated with a test. Only top-level test suites (below) must be disabled for this setting to take effect. |
| Only top-level test suites | Determines whether the Test Suite Summary report section only lists the .tst files (with this option enabled) or displays a tree-like view of the individual tests in each .tst file (with this option disabled). This is for SOAtest only. |
| Active static analysis rules | Determines whether the report lists the static analysis rules that were enabled for the test. |
| Detailed report for [coverage metric] | For Jtest, C++test, and dotTEST only. Determines whether detailed coverage information is provided for the specified coverage metric. Select the desired coverage type from the drop-down list. Important: In order to generate a detailed coverage report, enable this option (and select the desired coverage metric) BEFORE running tests. |
| Only tests that failed | Specifies whether the report lists only tests that failed. |
| Generate formatted reports in command-line mode | Determines whether formatted reports are generated for tests run in command line mode. |
| Cutoff date for graphs | Specifies the start date for trend graphs that track different categories of tasks over a period of time. |
| Info | ||||
|---|---|---|---|---|
| ||||
If you are specifying a URL for the artifact (e.g., as a SOAtest C++test test property), that URL will be available as a hyperlink in HTML reports. If want to create hyperlinks and you are specifying artifact associations using only the artifact ID as specified in Correlating Jtest, C++test, and dotTEST Tests Change-based Testing and Traceability, you can use local properties to specify how the ID maps to a URL. For example:
|
...
| Setting | Description |
|---|---|
| Format | Specifies the desired report format:
|
| XSL file | If you chose custom XSL as the report format, specify the path to the XSL file that defines your custom format. |
| Report file extension | If you want to use a file extension other than the default .html extension, specify that extension here. |
| Generate additional archive with entire report content | Enable this option to generate an additional compressed archive (.zip) file in the specified report location. The ZIP file contains all the files generated to build the report. This option can generate an archive for any report format (e.g., HTML, CSV, PDF, etc.). By generating an archive, you can also perform custom transformations of the report because all of the elements are generated to the specified destination folder. |
...
| Setting | Description |
|---|---|
| Add absolute file paths to XML data | Specifies whether absolute file paths are added to XML data. This needs to be enabled on the Server installation if you want to relocate tasks upon import to desktop installations (as described in Relocating Tasks During Import: Requirements and Limitations). |
| Add metric details to XML data: | For Jtest, C++test, dotTEST only. Specifies whether type-level and method-level metrics details are added to the XML report (in addition to project and package/namespace-level details, which are included by default). Metrics details will be shown in HTML and PDF reports. |
| Session tag | Specifies a tag for this report. This value is used for uploading summary results to Team Server. The results from each of the team’s regular test runs should have a unique tag. Variables can be used as described in Using Preference Settings for Command-Line Execution. For instance, if your team runs static analysis, unit testing, and code review, you might use the session tags Static, Execution, and Code Review. Or, you might use variables such as session.tag=${config_name} or session.tag=${analysis_type} |
...
Reporting options can be specified in localsettings (e.g. for sharing team-wide settings via Concerto DTP or specifying options at the command line). See Configuring Localsettings for details.
...
| 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: jtestclicpptestcli: -config team://xtest-static.properties -localsettings /home/nightly/localsettings.properties -publish -report /home/nightly/reports/report.html -resource myproject -concertodtp.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 "Suppressions details" option. See Report Configuration Settings for details. |
| dev_errors=true|false | The value of the "Task details" option. See Report Configuration Settings for details. |
| dev_reports=true|false | The value of the "Detailed report for developers" option. See Report Configuration Settings for details. |
| show_active_rules=true|false | The value of the "Active static analysis rules" option. See Report Configuration Settings for details. |
| associations=true|false | The value of the "Requirement/defect details" option. See Report Configuration Settings for 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')"/> |
| exec_cvg_details=true|false | The value of the "Detailed report for" option. See Report Configuration Settings for details. |
| attachments=true|false | The value of the localsettings key report.mail.attachments. See Configuring Localsettings for details. |
| test_suites_only=true|false | The value of the localsettings key report.test_suites_only. See Configuring Localsettings for details. |
| test_cases_details=true|false | The value of the "Test case details" option. See Report Configuration Settings for details. |
| failed_tests_only=true|false | The value of localsettings key report.failed_tests_only. See Configuring Localsettings for details. |
| authors_details=true|false | The value of the "Overview of tasks by authors" option. See Report Configuration Settings for details. |
| contexts_details=true|false | The value of the "Overview of checked files and executed tests" option. See Report Configuration Settings for details. |
...