If you want to monitor a specific set of test results in the Test Manager, you can create a custom view filter.
The custom view filter is unique to the test suite. When the harness opens the test suite in the Test Manager, it restores the custom filter, including any name that you assign it.
You can also use the custom filter to generate reports. See Creating Reports for a description of using the Custom filter when generating reports.
Using Test Suite Areas, Keywords, Prior Status, Exclude Lists, and Special settings in the view filter does not stop the harness from running these tests. To filter the tests that are run, you must change the values in the configuration. See Editing a Configuration for a detailed description.
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 harness walks the test tree starting with the sub-branches and 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 harness enables the Expression button.
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
To display only the results for tests containing the |
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 |
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
To display results for only the tests with the |
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 Filter | Action |
---|---|
Passed | Displays tests with passed results the last time the test was executed. |
Failed | Displays tests with failed results the last time the test was executed. |
Error | Displays tests that the 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 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 this filter.
You must select this setting to correctly simulate the Current Configuration settings.
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 updates the status of the folders and tests in the test tree that match the filter settings of the custom filter.
Copyright © 2002, 2009, Oracle and/or its affiliates. All rights reserved.