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. The precedence column indicates the order in which the expression is resolved. Expressions in parentheses are evaluated first, with nested parentheses being evaluated from the innermost parentheses outward.

Logical Operator Precedence Description
( ) group 1

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.

! not 2 Logical 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.

& and 3 Logical 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 choose tests that include both keywords.

| or 4 Logical or. Used to specify either of 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 choose tests that include either keyword.


Copyright © 2001, 2011, Oracle and/or its affiliates. All rights reserved.