This transformer is processing binary data before sending it to next transformer or to final recipient. The data is split into chunks according to the transformer properties.
Binary splitter 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.
- Binary block end bytes (hex string): Split input data into chunks ending with specified bytes.
- Binary block start bytes (hex string): Ignored, if "Binary block end bytes" not defined. The result chunk is normalized by removing extra bytes before "start bytes".
Hex strings can be defined in any of the following formats:
- 0x11 0xaa 0xbb
- 11 aa bb
- 11 AA bB
- 11aabb
Binary block end bytes: FF FF
Example: Simple packet.
- Input: FF FF
- Output: FF FF
Example: 2 simple packets
- Input: FF FF FF FF
- Output 1: FF FF
- Output 2: FF FF
Example: 2 simple packets
- Input: 00 00 FF FF
- Output: FF FF
Example: 2 simple packets
- Input: 00 00 FF FF
- Output: FF FF
Example: Extra FF symbol in the end
- Input: AA 00 AA 00 00 00 FF FF FF
- Output: AA 00 AA 00 00 00 FF FF (last FF is not included)
Binary block start bytes: 00 00
Binary block end bytes: FF FF
Example: Simple packet
- Input: 00 00 FF FF
- Output: 00 00 FF FF
Example: Invalid byte EE between 2 valid packets. Result: both packets are sent, EE byte is removed.
- Input: 00 00 FF FF EE 00 00 00 FF FF
- Output 1: 00 00 FF FF
- Output 2: 00 00 00 FF FF
Example: Invalid bytes in the beginning and extra 0xff in the end. Result: invalid bytes in the beginning removed, last 0xff not included in output.
- Input: AA 00 AA 00 00 FF FF FF
- Output: 00 00 FF FF
Example: Invalid bytes in the beginning and extra 0xff in the end. Result: invalid bytes in the beginning removed, last 0xff not included in output.
- Input: AA 00 AA 00 00 00 FF FF FF
- Output: 00 00 00 FF FF
Example: Invalid bytes in the beginning and extra 0xff in the end. Result: invalid bytes in the beginning removed, last 0xff not included in output.
- Input: AA 00 AA 00 00 00 FF FF FF AA 00 AA 00 00 00 FF FF FF
- Output1: 00 00 00 FF FF
- Output2: 00 00 00 FF FF