# Test Results Auditor Tool

Use the Test Results Auditor tool (Audit tool) to generate and view an audit report of the test results in a work directory. The Audit tool verifies that all tests in a test suite ran correctly and identifies any audit categories in a test run with errors. To launch the Audit tool, choose Tools > Test Results Auditor from the menu bar. The harness opens the tool window and an options dialog box. The options dialog box is used to specify the audited test suite, work directory, and configuration file.

The Test Results Auditor contains the following items:

1. Audit Tool Menu Bar
2. Audit Settings
3. Audit Results

See Audit Test Results Options for a detailed description of the options dialog box.

See Auditing Test Results for a detailed description of using the Audit tool to generate and view an audit report of the test results in a work directory.

## Audit Tool Menu Bar

The Audit tool menu bar contains an Audit and a Help menu. The menu bar also contains harness standard menus when the Tabbed and SDI window styles are used. See Layout Styles for a description of the different styles of windows that the harness provides.

Use the Audit menu to set options used to generate an audit report. See Audit Test Results Options for a description of the Options dialog box.

Use the Help menu to display online help for the Test Results Auditor window.

See Menus for a description of the harness standard menus that are displayed on the menu bar.

## Audit Settings

The following audit settings are displayed at the top of the window:

- Test Suite - Displays the name and location of the reference test suite.
- Work Directory - Displays the name and location of the audited work directory.
- Configuration File - Displays the name and location of the reference configuration interview.

Use the options dialog box to specify the values in these fields. See Audit Test Results Options for a detailed description of the options dialog box.

## Audit Results

The harness displays the audit report in the following five tabbed panels:

- Summary
- Bad Result File
- Bad Checksum
- Bad Test Description
- Bad Test Cases

### Summary

The following table describes the audit category state and details displayed in the Summary panel.

Category | Description
--- | ---
Result Files | Displays a summary of the audit for corrupted and missing test result files. See Bad Result File for a description of the detailed tab.
Checksums | Displays a summary of the audit of the test result files checksums. See Bad Checksum for a description of the detailed tab.
Test Descriptions | Displays a summary of the audit of the test descriptions. See Bad Test Description for a description of the detailed tab.
Test Cases | Displays a summary of the audit of the exclude list. See Bad Test Cases for a description of the detailed tab.
Test Results | Displays a summary of the test results audit. To pass the audit, all tests must have passing results.
Time Stamps | Displays the date and time when the first and the last tests were run.

### Bad Result File

The Bad Result File panel lists any corrupted or missing test result files.

A corrupted or missing test result file is an indication that the result file was edited.

### Bad Checksum

The Bad Checksum panel lists all test result files with invalid checksums.

The result file checksums must match the reference checksums in the reference test suite. An invalid checksum is an indication that a result file was edited.

### Bad Test Description

The Bad Test Description panel lists all test files with edited test descriptions.

Test descriptions must match the reference test descriptions in the reference test suite. An invalid test description is an indication that the test file was edited.

### Bad Test Cases

The Bad Test Cases panel lists all tests that failed to execute the required test cases.

The test cases run must match the exclude list for the reference test suite. Tests that failed to execute the required test cases are indications that the exclude list was edited.

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