The JavaTest harness does not automatically create reports of test results after a test run. You can create test reports either from the command line in batch mode (see Writing Reports in the JavaTest Harness User's Guide: Command-Line Interface) or from the JavaTest harness GUI. To create a test report from the JavaTest harness GUI, you must complete these steps:
The JavaTest harness opens the Create a New Report dialog box.
You can either specify a new directory or an existing directory. If you ran reports earlier, it displays the directory from the previous run. If you use an existing report directory, the JavaTest harness can save the previous reports as backups when it writes the new reports. Use the settings in the Other Options tab to backup old reports and specify the number of backup reports to keep in the report directory.
If you only generate a text report without html reports in an existing directory
containing html reports, you must use an external text editor or web
browser to view the summary.txt
file. To use the Report Browser when viewing
text reports, generate the text only report either in a new report directory
or in an existing report directory that only contains plain text reports.
The Report Results for field specifies the filter used to select the test results that are reported. You can choose Last Test Run, Current Configuration, All Tests, Custom, or Certification. If the Custom filter was previously renamed, the dialog box displays the current name of the custom filter. You can create or modify a custom filter for generating test reports for a specific set of test criteria.
See Using View Filters for a description of the filters.
See Custom View Filter for a description of how to create a custom view filter.
The JavaTest harness writes the reports and displays a dialog box that gives you the option of either viewing the new reports in the report browser or returning to the Test Manager window.
The options set in this dialog are persistent. Once the options are set they are used each time a report is generated. These settings also apply to reports printed from the command-line interface.
In the Report Formats tab, choose the report formats generated by the JavaTest harness. If you choose to generate only the plain text report format in a report directory containing an existing HTML report, you must use an external text editor or web browser to view the summary.txt file. To use the Report Browser when viewing text reports, generate the text only report either in a new report directory or in an existing report directory that only contains plain text reports.
If you selected HTML Report in the Report Formats tab, use the HTML Options tab to select the sections of the main HTML report file that are generated.
The following options are available for generating HTML reports:
If the HTML report format is selected, in the HTML Files tab, choose the main report location and choose the report files that you want generated.
In the Other Options tab, you can choose to backup the previous report files. You can also choose the number of report backups that are maintained by the JavaTest harness.
If the Backup old reports option is selected, the JavaTest harness
saves the previous reports as backups by appending a sequential numeric to the
html extension (such as failed.html~1~
). The JavaTest harness maintains
the specified number of copies by deleting the oldest copy when the limit of
backups is reached for a specific report. Changing this or any other setting
in the report dialog box does not alter any previously saved backup reports.
Existing backups are not deleted if backups are turned off and file names are
not changed as old backups are deleted.