Match Regular Expression Filter dialog box

This filter checks if the input string contains a substring that matches a specified regular expression.

The component uses the ECMAScript grammar to evaluate regular expressions. For more information about ECMAScript grammar, see Regular Expressions in the MSDN Library or the official website.
Option Description
Field name Enter the field name of the FRTN generated by the filter.
Input Enter a string to be checked for inclusion of a substring matching regular expression. Commonly, RRT is used in this text box.
Match Enter a regular expression.
The filter generates an error if the regular expression specified by the Match parameter is invalid.
Match case If this check box is selected, then matching operation is case-sensitive. Otherwise it is case-insensitive.
Fail job if input/output is invalid If this check box is selected, the component will reject the current job if the input is empty.
Result This group of settings allows configuring values that will replace the generated RRT in case of success and in case of failure.
On success Specify a value for replacement of the generated RRT in case if the matching is successful. You can select the value from the predefined alternatives (TRUE, YES, ON, 1) from the drop-down list or enter any other value manually. The default value is TRUE.
On failure Specify a value for replacement of the generated RRT in case if the matching fails. You can select the value from the predefined alternatives (FALSE, NO, OFF, 0) from the drop-down list or enter another value manually. The default value is FALSE.
Test Click this button to check the correctness of the specified regular expression in the Test Regular Expression dialog box.

This filter generates the following Boolean RRTs:

  • ~DFT::%field name#IsSuccess%~ is replaced with TRUE if the filter operation ends with success; otherwise, it is replaced with FALSE.
  • ~DFT::%field name#IsFailure%~ is replaced with TRUE if the filter operation ends with failure; otherwise, it is replaced with FALSE.

Result RRT:

~DFT::%field name%~ is replaced with the value configured as a success result if the input string contains a sub-string that matches the specified regular expression, and is replaced with the value configured as a failure result otherwise.

This filter generates the following RRTs to represent results of matching capture groups and sub-strings:

  • ~DFT::%field name#Result%~ is replaced with the value of the sub-string that matches the specified regular expression in the input string.
  • ~DFT::%field name#Result,Index%~ is replaced with the value of the capture group of index number Index.

Examples of the filter usage:

Example 1:

Input: Are there digits (1, 2, ...) in this string?

Match: [0-9]

Match case: unselected

On Success: TRUE

On Failure: FALSE

The generated RRT will be replaced with: TRUE.

Example 2:

Input: fat gfoot fot

Match: (f)(o*)t

The generated result RRTs will be replaced as follows:

~DFT::%field name#Result%~: foot

~DFT::%field name#Result,0%~: foot

~DFT::%field name#Result,1%~: f

~DFT::%field name#Result,2%~: oo

~DFT::%field name#Result,3%~ and all RRTs with the following indexes will be replaced with the empty value.