Text transformer

Description

Transformer is processing data before sending it to next transformer or to final recipient.

This transformer will not work correctly with binary data.

Text transformer properties:

• Enabled (boolean). If enabled, transformer will be used for data processing.
• Read only (boolean). If set as read only, the transformer will not send any data to next recipient.
• WaitForNewLine (boolean): If enabled, transformer will buffer data and not send to next recipient until "NewLineSeparator" is received.
• IsNewLineSeparatorInHexFormat (boolean): if true, "NewLineSeparator" will be parsed as binary string (like "0x11 0x12" or "aa bb cc" etc)
• RemoveLineSeparatorsAfterScan (boolean): if true, NewLineSeparator will be removed before sending data to next recipient.
• NewLineSeparator (string): default value is 0xa (\n). If WaitForNewLine is set to true, the transformer will wait for end of the string (last occurrence) and will send all characters before + line ending symbols (unless RemoveLineSeparatorsAfterScan is true).
• Regex_Replace_From (string): regex expression to replace incoming data from. If empty, ignored.
• Regex_Replace_To (string): regex expression to replace incoming data (defined by Regex_Replace_From) with.

Example: Removing digits from specific string

To replace data like "test123", "test33333" etc to just "test", use the following regex expression:

Regex_ReplaceFrom: test([\d]+)
Regex_ReplaceTo: test

Example: Removing specific character

To remove all '1' characters from stream, set Regex_ReplaceFrom to 1 and set Regex_ReplaceTo to empty string:

Regex_ReplaceFrom: 1
Regex_ReplaceTo:

Example: Replacing all '1's with '2's:

Regex_ReplaceFrom: 1
Regex_ReplaceTo: 2