When the Current Configuration and the All Test view filters do not provide a suitable view of the test tree, you can use the Filter Editor to create a Custom filter for the test suite.
The Custom filter is unique to the test suite. When the JavaTest harness opens the test suite in the Test Manager window, it restores the Custom filter, including any name that you assigned it.
You can also use the Custom filter to generate reports. See Creating New Reports for a description of using the Custom filter when generating reports.
To edit the Custom filter:
button at the bottom of the test tree.
Using Test Suite Areas, Keywords, Prior Status, Exclude Lists, and Special settings in the view filter does not stop the JavaTest harness from running these tests. To filter the tests that are run you must use the Standard Values View of the Configuration Editor.
Click the Test Suite Areas tab and use the tree to choose the results of test folders or individual tests that you want displayed in the Test Tree. The JavaTest harness walks the test tree starting with the sub-branches and/or tests you specify and displays the results of all tests that it finds.
If your test suite provides keywords, you can use the Keywords pane to restrict the set of test results displayed in the test tree and in the Summary pane.
To specify the keywords:
The following table provides descriptions and examples of keyword expressions that can be constructed:
| Expression | Description |
|---|---|
| Any Of |
Displays all tests in the test suite having any of the keywords entered in the text field.
Example: A test suite uses the keyword "interactive" to identify tests that require human interaction, and "color" to identify tests that require a color display. To display only the results for tests containing the "interactive" keyword, choose Any Of and then use the interactive keyword. |
| All Of |
Displays results for all tests in the test suite having all of the keywords entered in the text field.
Example:
To display results for only the tests containing both the "interactive" and "color" keywords, choose All Of and then use the interactive and color keywords. |
| Expression |
Displays results for all tests in the test suite having the expression entered in the text field.
Construct a boolean expression in the text field. Keywords stand as boolean predicates that are true if, and only if, the keyword is present in the test being considered. A test is accepted if the overall value of the expression is true; all other tests are rejected by the restriction. Example: A test suite uses the keyword "interactive" to identify tests that require human interaction, and "color" to identify tests that require a color display. To display results for only the tests with the "color" keyword that do not also contain the "interactive" keyword, choose Expression and then use the color keyword, the ! operator, and the interactive keyword. |
Click the Prior Status tab and choose the test results from the previous test run that you want displayed in the Test Tree.
| Prior Status | Action |
|---|---|
| Passed | Displays tests that passed the last time the test was executed. |
| Failed | Displays tests that failed the last time the test was executed. |
| Error | Displays tests that the JavaTest harness could not execute the last time it was included in a test run. |
| Not Run | Displays tests without results in the current work directory. |
Prior status is evaluated on a test-by-test basis using information stored in the result files (.jtr) that are written in the work directory. Unless overridden by a test suite, a result file is written in the work directory for every test that is executed. When you change work directories between test runs, the result files in the previous work directory are no longer used and, if the new work directory is empty, the JavaTest harness behaves as though the test suite was not run.
To use the exclude list specified in the configuration interview as a filter, click the Exclude Lists tab and the Use settings in interview check box. The Exclude Lists pane displays the name of the exclude list file used by the current configuration.
Any test in the exclude list is filtered out and displayed as a 
icon in the test tree.
If the test suite architect provides a default filter for the test suite, click the Special tab and the Enable test suite filter check box to select his filter.
Select this filter setting to simulate the current configuration without changing the interview.
To use a custom filter, you must choose it from the list of view filters below the test tree or from the View > Filters menu. The Test Manager window updates the status of the folders and tests in the test tree that match the filter settings of the custom filter.