Creating Reports

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 Create a New Report dialog box
  1. Choose Report -> Create Report from the Test Manager menu bar.

The JavaTest harness opens the Create a New Report dialog box.

  1. Type the name of a report directory in the Report Directory field or click the Browse button to specify where to put the new reports.

    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.

  2. Use the tabbed panes to set printing formats and options. See Report Formats, HTML Options, HTML Files, and Other Options for a description of the formats and options that you can set.
  3. Click the Create Report(s) button.

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.

Report Formats

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.

The Create a New Report dialog box

HTML Options

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 New Report dialog box - HTML Options tab

The following options are available for generating HTML reports:

HTML Files

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.

The New Report dialog box - HTML Files tab

Other Options

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.

The New Report dialog box - Other Options tab

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.