Test Tree Popup Menu

The test tree provides a popup menu for each folder and test icon. Displaying the popup menu for a folder or test is a platform specific operation (such as right clicking the folder or test icon in the test tree). Shift F10 can also be used to display the popup menu for the item having focus.

Execute these tests - "Quick Pick" Test Execution
Refresh - Refresh Test Suite Contents
Clear Results - Clear Previous Test Results

The JavaTest harness does not allow you to perform operations using the popup menu when it is running tests. The JavaTest harness displays an error dialog box if you attempt to perform an operation using the popup menu when tests are running.

See Keyboard Access for a description of how the keyboard can be used to open and navigate the popup menu.

"Quick Pick" Test Execution

You can use the Execute these tests menu item to run either a single test or all of the tests in a folder. Multiple tests and multiple folders cannot be run using the popup menu.

The JavaTest harness does not automatically perform a refresh operation before running the tests. If changes have been made to a test suite, you must perform a refresh before running tests. See Refresh Test Suite Contents for a description of the refresh operation.

To perform a "Quick Pick" test execution of a folder or a test:

Select a folder or test in the test tree and then open the popup menu.
Opening the popup menu is a platform specific operation (such as right clicking the folder or test icon in the test tree).

Selecting a single test executes only that test.
Selecting a folder executes all tests currently known to the test manager in and below that folder.

Choose Execute these tests from the test tree popup menu.
The JavaTest harness uses the "Quick Pick" tree selection (in place of the "Tests" selection from the Standard Values view) and the remaining values from the current configuration to run the tests.

If the test manager does not contain a completed configuration, the JavaTest harness displays an advisory message and does not start the test run.
If the test manager contains a completed configuration, the JavaTest harness displays an advisory message to confirm the execute operation.

As it does during a routine test run, the JavaTest harness updates all icons and progress monitors during test execution.

Refresh Test Suite Contents

When developing tests, changes in a test suite are not automatically detected by the JavaTest harness. The first time tests are run, the JavaTest harness uses the test finder to read test descriptions. If the harness loads tests from an existing work directory, the test descriptions contained in those results will be used by default.

The refresh operation allows test developers to load changes they may have made in a test suite without restarting the JavaTest harness or reloading the test suite.

The JavaTest harness does not require a work directory to perform a refresh of the test suite.

If you are viewing the test panel after refreshing a test or folder, update the test tree by choosing a different test or folder icon and then repeating your test tree choice.

Refresh a Single Test

To refresh the contents of a test:

Select the test in the test tree and then open the popup menu.
Opening the popup menu is a platform specific operation (such as right clicking the test icon in the test tree).
Choose Refresh from the popup menu.
The JavaTest harness checks the time stamp of the file containing the test description.
If the time stamp has changed, it compares the test descriptions.
If the properties of the test descriptions are different, the JavaTest harness:

Removes the test result from the work directory and the test manager.
Loads a test containing the new test description into the test manager and displays it in the "not run" state.

Refresh a Folder

To refresh the contents of a folder:

Select the folder in the test tree and then open the popup menu.
Opening the popup menu is a platform specific operation (such as right clicking the folder icon in the test tree).
Choose Refresh from the test tree popup menu.
The JavaTest harness scans for new folders and tests. This operation may take place on any folder, including the root folder.
The JavaTest harness checks the time stamps of the files in a folder.
If a time stamp has changed, the JavaTest harness compares the test descriptions.
If the properties of the test descriptions are different, the JavaTest harness:

Removes the test result from the work directory and the test manager.
Loads the test containing the new test description into the test manager and displays it in the "not run" state.

Clear Previous Test Results

You can use the Clear Results menu item to remove existing test results for a single test or for all of the tests in and below a folder.

To clear test results, you must have an open work directory.

Clear a Single Test Result

To clear a test result:

Select the test in the test tree and then open the popup menu.
Opening the popup menu is a platform specific operation (such as right clicking the test icon in the test tree).
Choose Clear Results from the test tree popup menu.
The JavaTest harness:

Removes the .jtr file from the work directory for that test.
Refreshes the test description for that test.
Displays the test in the "not run" state.

Clear Test Results in a Folder

To clear the test result in a folder:

Select the folder in the test tree and then open the popup menu.
Opening the popup menu is a platform specific operation (such as right clicking the folder icon in the test tree).
Choose Clear Results from the test tree popup menu.
The JavaTest harness:

Removes all .jtr files from the work directory for all tests in and below that folder.
Deletes all other files in and below the folder in the work directory.
Deletes all other directories corresponding to the folders in and below the folder in the work directory.
Displays the folder and its tests as "not run."

The JavaTest harness does not display an error message if it is unable to delete a folder or file from the work directory.