The Custom Filter

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 edit the Custom filter for the test suite.

The Custom filter is unique to a test suite. When the JavaTest harness opens the test suite in the Test Manager window, it also restores its Custom filter. You can also use the Custom filter to generate reports. See Generating New Reports for a description of using the Custom filter when generating reports.

The Custom View Filter Editor

Editing the Custom Filter

To edit the Custom filter:

  1. Choose View > Filters > Configure Filters from the menu bar or click the The Custom View Filter Editor button button at the bottom of the test tree.
  2. Choose Custom in the Available Filters panel. You can provide a name for the filter in the Custom Label field.
  3. Use the Test Suite Areas, Keywords, Prior Status, Exclude Lists, and Special tabs to set the view filter properties:
  4. Click one of the following buttons:

Using Test Suite Areas, Keywords, Prior Status, Exclude Lists, and Special settings to filter the displayed test results does not stop the tests from running. To specify which tests are run, use the Configuration Editor Standard Values View.

Specifying Tests to View

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.

Using Keywords as a View Filter

If your test suite provides keywords and you want to use them to filter the test results displayed in the Test Tree, click the Keywords tab.

See Specifying Tests to Run for a description of the behavior of this view filter.

See Using Keywords as a Filter for a description of how to select the keywords available for your test suite.

Using Prior Status as a View Filter

Click the Prior Status tab and choose the test results from the previous test run that you want displayed in the Test Tree.

See Specifying Tests to Run for a description of the behavior of this view filter.

Using the Exclude List as a View Filter

To use the exclude list specified in the configuration interview as a filter, click the Exclude Lists tab and its check box.

Any test in the exclude list is filtered out and displayed as a Test Filtered Out icon in the test tree.

Using Special Settings as a Filter

The test suite architect has the option of providing a default filter for the test suite. The default filter is automatically used in the Current Configuration view.

Select this filter setting when you are simulating the current configuration without actually changing the interview.

Example:
You want to display the tests in the GUI that are marked with a keyword and do not want to change your interview, click Enable test suite filter.

Using a Custom View Filter

To use a custom filter, choose it from the list of view filters below the test tree or from the View > Filters menu. The JavaTest harness displays the status of the folders and tests in the test tree that match the filter settings of the custom filter.