Action: FilterRegularExpression

Function: The action uses regular expressions to process strings.

Call: System test driver

Tab: Configuration

Input string

String in which a specific pattern (substring) is searched for

Regular Expression

Regular expression which defines the search pattern

Output Parameters

Parameter where the found substrings are saved

The parameter name is specified without quotation marks.

Example: {RegExResult}

If Check for match option is enabled, then the entry is optional. In all other cases, an outbound parameter has to be specified.

Table 72. Output options

If no match is found when the action is executed, then the action fails. If a match is found, then the next behavior depends on the selected option.
Check for match	When an output parameter is configured, it gets the value `TRUE`. The action returns successfully.
Find first match	The string of the first match is written to the output parameter. The action returns successfully.
Find all matches, separate results by	All matches are combined into a string separated by the specified text and assigned to the output parameter.
Replace matches with	All matches are replaced by the configured text. The result of this replacement is assigned to the initial parameter.

Tab: Parameters

The parameters defined on the Parameters tab are used to exchange values between test script variables and parameters of test actions. Parameters can be used as placeholders on the Configuration tab. For this, the name of the parameter is set in braces in the configuration dialog. Example: {name}.

Tip

Variables defined globally in the script (with the prefix $GLOBALS.) can be used directly in the test action. It is not necessary to use input parameters for passing. Using output parameters is necessary for writing global variables.

Input parameters: When executing the test action, the values of the test script variables are passed to the input parameters of the test action and can be used in the configuration of the test action.
Output parameters: When executing the test action, the values of the output parameters of the test action are passed to the test script variables and can be used (for example, in other test actions).
Name	Name of the input/output parameter This name is defined in addition to the variable name to identify the origin of the parameter when it is passed to another script. During the test run, this name is displayed as the Outer name on the Variables (scope #<n>) tab in the Test progress window. Background: When a script `A` calls another script `B`, and its variable `x` passes `y` as a parameter to the script `B`, then the parameter `y` is the variable `y` from the point of view of script `B`. To see that this variable is recognized as variable `x` "outside" of script `B`, there is the Name column ("Outer name"). The variable `y` has the name `x` in the scope pf script `B` because it has been passed as variable `x` to the parameter `y` in the scope of the calling script `A`.
Variable	Name of the test script variable Example: `TS_CaseA_Result`
Move Up	Moves the selected variable one line up
Move Down	Moves the selected variable one line down
Remove	Removes the selected variable from the list