# Displaying Reports

You can use the Report browser or a web browser to display harness reports.

If you choose to only generate a text report 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.

## Display Reports in the Report Browser

To display reports in the report browser:

1. Choose Report > Open Report from the menu bar.

> The harness opens a file chooser dialog box for you to specify a report directory. When you specify a report directory, the harness opens the Report Browser.

2. Choose the report format from the directory listing.

- If you choose the text format version of the report, the browser displays a `summary.txt` hyperlink to the summary page. The summary page provides a text list of tests that were run and their test result status.
- If you choose the XML format version of the report, the browser displays a `report.xml` hyperlink to the XML report page. The XML Report page provides a report of the configuration values used to run the tests, the tests that were run, and their test result status.
- If you choose the HTML format version of the reports, a second directory listing is displayed.

3. Choose the report.html hyperlink to open the HTML reports.

4. Use the hyperlinks within report.html to display the detailed report files in browser.

### Report Browser Contents

The following table describes the contents of the Report Browser.

Component | Description
--- | ---

Menu bar

The menu bar contains a File and a Help menu.

- Use the File menu to generate new reports, open existing reports, and to close the Report Browser.
- Use the Help menu to display Report Browser online help.

tool bar

The tool bar contains a File field and three navigation buttons.

The File field displays the name of the current report and provides a drop-down list of reports previously opened in the browser. As reports are opened, the harness adds their names to the drop-down list enabling you to navigate to any previously displayed report.

Returns to the previously displayed report page.

Opens the next report page that was displayed.

Returns to the `report.html` file. The `report.html` file is the root page and links to all of the other test report pages.

Contents area | The Report Browser displays the report file contents in the area below the tool bar. The Report Browser displays text files as well as HTML files. For HTML files, you can use hyperlinks in the report to display additional related reports.

See Keyboard access for a description of how the keyboard can be used to navigate the Report Browser.

### HTML Report Files

The following table lists and describes the HTML report files.

Report Files | Description
--- | ---
`config.html` | Contains the configuration interview questions and your answers used for the test run.
`env.html` | Contains the name-value pairs derived from the configuration file that were used for the test run.
`error.html` | Contains a list of the tests that had errors and could not be run.
`excluded.html` | Contains a list of the tests that were excluded from the test run.
`failed.html` | Contains a list of the tests that were executed during the test run but failed.
`notRun.html` | Contains a list of all tests that were not excluded from the test run but were not run.
`passed.html` | Contains a list of the tests that were executed during the test run and passed.
`report.html` | Contains links to all of the HTML files and additional information.

## Viewing Reports Offline

You can view the reports offline by opening the `html` files in a web browser or the `summary.txt` report in any text editor.

The `report.html` file is the root file that links to the other HTML reports. The `summary.txt` report contains a list of all tests that were run, their test results, and their status messages.

Copyright © 2002, 2010, Oracle and/or its affiliates. All rights reserved.