Using Keywords as a Run Filter

NOTE: The JavaTest harness displays this tab only if your test suite usesd keywords.

If your test suite uses keywords, you can use the Keywords pane in the Standard Values view to restrict the set of tests to be run.

Keywords pane from the Configuration Editor: Standard Values view

To specify the keywords and how they are used to restrict the tests in a test run, click Select tests that match. The JavaTest harness enables the Expression, Insert Operator, and Insert Keyword buttons.

Build an expression in the text field by using the Insert Keyword and Insert Operator buttons.

Click the Expression button to display a list of expressions that can be constructed. From the list, choose the type of expression that you are building.
Click the Insert Keyword button to display the list of keywords provided by the test suite for use in filtering tests. From the list, choose the keywords used in the expression.
Click the Insert Operator button to display a list of operators that you can use to construct boolean expressions in the text field. From the list, choose the operator used in the expression.

The following table provides descriptions and examples of keyword expressions that can be constructed:

Expression	Description
Any Of	Runs 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 execute only the tests containing the "interactive" keyword, choose Any Of and then use the Insert Keyword button to choose the interactive keyword.
All Of	Runs all tests in the test suite having all of the keywords entered in the text field. Example: To execute only the tests containing both the "interactive" and "color" keywords, choose All Of and then use the Insert Keyword button to choose the interactive and color keyword.
Expression	Runs all tests in the test suite having the expression entered in the text field Use the Insert Keyword and the Insert Operator buttons to 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 execute only the tests with the "color" keyword that do not also contain the "interactive" keyword, choose Expression and then use the Insert Keyword button to choose the color keyword, the Insert Operator button to choose the ! operator, and the Insert Keyword button to choose the interactive keyword,

Expression

Description

Any Of

Runs 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 execute only the tests containing the "interactive" keyword, choose Any Of and then use the Insert Keyword button to choose the interactive keyword.

All Of

Runs all tests in the test suite having all of the keywords entered in the text field.

Example:

To execute only the tests containing both the "interactive" and "color" keywords, choose All Of and then use the Insert Keyword button to choose the interactive and color keyword.

Expression

Runs all tests in the test suite having the expression entered in the text field

Use the Insert Keyword and the Insert Operator buttons to 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 execute only the tests with the "color" keyword that do not also contain the "interactive" keyword, choose Expression and then use the Insert Keyword button to choose the color keyword, the Insert Operator button to choose the ! operator, and the Insert Keyword button to choose the interactive keyword,