Applies Regular Expressions to the content of a FlowFile and routes a copy of the FlowFile to each destination whose Regular Expression matches. Regular Expressions are added as User-Defined Properties where the name of the property is the name of the relationship and the value is a Regular Expression to match against the FlowFile content. User-Defined properties do support the Attribute Expression Language, but the results are interpreted as literal values, not Regular Expressions
route, content, regex, regular expression, regexp, find, text, string, search, filter, detect
In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values.
| Display Name | API Name | Default Value | Allowable Values | Description |
|---|---|---|---|---|
| Match Requirement | Match Requirement | content must match exactly |
| Specifies whether the entire content of the file must match the regular expression exactly, or if any part of the file (up to Content Buffer Size) can contain the regular expression in order to be considered a match |
| Character Set | Character Set | UTF-8 | The Character Set in which the file is encoded | |
| Content Buffer Size | Content Buffer Size | 1 MB | Specifies the maximum amount of data to buffer in order to apply the regular expressions. If the size of the FlowFile exceeds this value, any amount of this value will be ignored |
Supports Sensitive Dynamic Properties: No
Dynamic Properties allow the user to specify both the name and value of a property.
| Name | Value | Description |
|---|---|---|
| Relationship Name | A Regular Expression | Routes FlowFiles whose content matches the regular expression defined by Dynamic Property's value to the Relationship defined by the Dynamic Property's key Supports Expression Language: true (will be evaluated using flow file attributes and variable registry) |
| Name | Description |
|---|---|
| unmatched | FlowFiles that do not match any of the user-supplied regular expressions will be routed to this relationship |
A Dynamic Relationship may be created based on how the user configures the Processor.
| Name | Description |
|---|---|
| Name from Dynamic Property | FlowFiles that match the Dynamic Property's Regular Expression |