Skip to content

Regular Expression Evaluator#

The Regular Expression Evaluator applies Regular Expressions (RegEx) to input data for pattern matching, extraction, replacement, or validation purposes. It is useful for tasks such as parsing structured text, extracting specific data points, or transforming text using substitution patterns.

Regular Expression Evaluator screenshot

Note

This task results from a split of the Expression Evaluator task. It can be used along with Generic Expression Evaluator and XPath Expression Evaluator.

Workflows#

Data Flow Control Flow

Inputs#

Name Data Type Description
data String The text that the expressions are evaluated against
Activate any Triggers task execution

Note

The task takes a single fixed input. For upgrade guidance, see the XPath and Regular Expression Evaluator migration guide ↗.

Outputs#

Name Data Type Description
<custom list> <custom> Defines the output values generated by the expression
Success Boolean Returns true if the task completes successfully
Error Error Contains information about any error that occurs

Settings#

The General tab includes standard task settings and the following parameter:

Name Data Type Values Default Value Description
Evaluator Behavior enum EvaluateAll
EvaluateUntilTrue
EvaluateAll Defines whether all expressions are evaluated or evaluation stops after the first true result

Regular Expression Evaluator General Settings screenshot

The Outputs Tab includes the following settings:

Name Data Type Description
Name String Output Name
Friendly Name String The displayed output name
Type Long
Decimal
DateTime
Boolean
String
Integer
Defines the data type of the output
Expression Text Operation or pattern applied to the input value

Regular Expression Evaluator Output Settings screenshot

Evaluator Behavior#

The Regular Expression Evaluator applies a regular expression to input data and returns results that match the expression. When the expression has no capture groups, the whole match is emitted; when it has one or more capture groups, the group values are concatenated (with no separator) and emitted; when nothing matches, the output does not emit.

  • EvaluateUntilTrue: Evaluates the outputs in order and stops at the first expression whose result converts to Boolean true (true, t, yes, y, or 1), emitting only that output.
  • EvaluateAll: Evaluates every configured expression and emits each result on its own output.

An expression that fails does not stop the other expressions. The task emits the error on Error only when no output has a result, and then still emits Success.

Examples#

With data receiving ID=LOT123;STEP=07;READY=1, configure the Outputs tab as:

Name Type Expression Emits
lotId String ID=(\w+) LOT123
readyFlag Boolean READY=(1) true