RouteOnContent

Description:

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

Tags:

route, content, regex, regular expression, regexp, find, text, string, search, filter, detect

Properties:

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 NameAPI NameDefault ValueAllowable ValuesDescription
Match RequirementMatch Requirementcontent must match exactly
  • content must match exactly
  • content must contain match
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 SetCharacter SetUTF-8The Character Set in which the file is encoded
Content Buffer SizeContent Buffer Size1 MBSpecifies 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

Dynamic Properties:

Supports Sensitive Dynamic Properties: No

Dynamic Properties allow the user to specify both the name and value of a property.

NameValueDescription
Relationship NameA Regular ExpressionRoutes 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)

Relationships:

NameDescription
unmatchedFlowFiles that do not match any of the user-supplied regular expressions will be routed to this relationship

Dynamic Relationships:

A Dynamic Relationship may be created based on how the user configures the Processor.

NameDescription
Name from Dynamic PropertyFlowFiles that match the Dynamic Property's Regular Expression

Reads Attributes:

None specified.

Writes Attributes:

None specified.

State management:

This component does not store state.

Restricted:

This component is not restricted.

Input requirement:

This component requires an incoming relationship.

System Resource Considerations:

None specified.