Specifying Keywords

This is the start of a procedureTo directly specify the tests that are run, perform the following steps:

  1. Click the Quick Set Mode button Quick Set Mode button on the Test Manager tool bar or choose Configure > Edit Quick Set > Keywords in the menu bar.

The Configuration Editor opens in Quick Set Mode.

Keyword tab

The following text is a note
The harness displays this tab only if your test suite uses keywords.
You can use one or more keywords to restrict the set of tests that the harness
runs. In Question Mode, use the Keywords question to specify test run restrictions based on the keywords.

  1. Click the Keywords tab if it does not have focus.
  2. Click the Select tests that match checkbox.

The harness enables the Expression, Insert Operator, and Insert Keyword buttons.

  1. Build an expression in the text field by using any logical combination of the following actions:
  1. Click the Done button to save the configuration change.

List of Expressions

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.

List of Logical Operators

Logical operators are only available when Expression is selected in the list of expressions. The following table provides descriptions and examples of logical operators that can be used to build keyword expressions.

Logical Operator Description
& and Used to combine expressions.

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.

interactive&color

The harness will only chose tests that include both keywords.

| or Used to specify either two expressions.

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.

interactive|color

The harness will only chose tests that include either keyword.

! not Used to exclude tests containing the expression.

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.

!interactive&!color

The harness will exclude tests that include either keyword.

( ) group

Used to create groups of expressions.

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.

!(interactive&color)

The harness will exclude tests that include both keywords.


Copyright © 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.