sun.com docs.sun.com My Sun Worldwide Sites

Previous Previous     Contents     Next Next

5.4 Test Reports

A set of report files is created for every test run. These report files can be found in the report directory you specify. After a test run is completed, the JavaTest harness writes HTML reports for the test run. You can view these files in the JavaTest ReportBrowser when running in GUI mode, or in the web browser of your choice outside the JavaTest interface.

To see all of the HTML report files, enter the URL of the report.html file. This file is the root file that links to all of the other HTML reports.

The JavaTest harness also creates a summary.txt file in the report directory that you can open in any text editor. The summary.txt file contains a list of all tests that were run, their test results, and their status messages.

5.4.1 Creating Test Reports

ProcedureTo Create a Test Report in GUI Mode

  1. Click Report->Create Report from the JavaTest main menu.

    You are prompted to specify a directory to use for your test reports. The default location is <TS_HOME>/src/com/sun/ts/tests/signaturetests/saaj.

  2. Specify the directory you want to use for your reports, and then click OK.

    Use the Filter drop-down list to specify whether you want to generate reports for the current configuration, all tests, or a custom set of tests.

    You are asked whether you want to view report now.

  3. Click Yes to display the new report in the JavaTest ReportBrowser.

ProcedureTo Create a Test Report in Command-Line Mode

  • Specify where you want to create the test report.

    1. To specify the report directory from the command line at runtime, use:

      <TS_HOME>/bin/tsant -Dreport.dir="<report_dir>"

      Reports are written for the last test run to the directory you specify. The default location is <TS_HOME>/src/com/sun/ts/tests/signaturetests/saaj.

    2. To specify the default report directory, set the report.dir property in <TS_HOME>/bin/ts.jte.

      For example, report.dir="/home/josephine/reports".

    3. To disable reporting, set the report.dir property to "none", either on the command line or in ts.jte.

      For example:

      <TS_HOME>/bin/tsant -Dreport.dir="none"

5.4.2 Viewing an Existing Test Report

ProcedureTo View an Existing Report in GUI Mode

  1. Click Report->Open Report from the JavaTest main menu.

    You are prompted to specify the directory containing the report you want to open.

  2. Select the report directory you want to open, and then click Open.

    The selected report set is opened in the JavaTest ReportBrowser.

ProcedureTo View an Existing Report in Command-Line Mode

  • Use the Web browser of your choice to view the report.html file in the report directory you specified from the command line or in ts.jte.

Previous Previous     Contents     Next Next
Company Info Contact Terms of Use Privacy Copyright 1994-2006 Sun Microsystems, Inc.