Check the displayed text in a control against an expected string value; in the base of Boolean-state controls, check the current state against an expected Boolean value. Result is Passed if the values match; otherwise Failed.


TA name of the window.
TA name of the control.
Expected value.

Valid contexts

This action may be used within the following project items: test modules and user-defined actions.


  • value argument:
    • The value argument can accept regular expressions. Note that argument values that include regular expressions must be entirely enclosed in curly braces {}. As an example, {[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}} specifies the pattern for an acceptable email address. More simply, .* represents the general wildcard for regular expressions, so that {.*arch.*} matches starch, marching, testarchitect, etc.
    • An empty value argument results in Pass if the control's value is indeed empty; otherwise Fail.
    • In the case of Boolean-state controls, such as check boxes and radio buttons, the values 1, on, true and yes are all equivalent to the selected state, while 0, off, false and no are equivalent to the cleared state.
  • Note that the TA property of the control checked by this action varies by control class. In all cases, it is the property whose value is on display.
  • This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Applicable Built-In Settings

The following settings are applicable to this action: case sensitive , remove double quotes from cells, standard ASCII only, property wait, page wait, object wait, value changed wait, window wait, load invisible controls .

Applicable Controls

This action is applicable to the following controls: check box, combo box, date picker, datetime, label, progress bar, radio button, rating bar, richtext, slider, status bar, switch, text box, text view, toggle button, trackbar, calendar.
Note: When getting very long strings from an SAP BW richtext control, you may experience perfomance issues.


Action Lines