Business Integration Solutions Documentation

About: SPLITTER Activity

In Business Integration Solutions, use the SPLITTER activity to break the composite message into a series of individual messages, each containing data related to one item.

Usage

Use this activity to split a big chunk of message into small messages, where each message is self-contained and easy to process.

Concept

The Splitter activity consumes one message containing a list of repeating elements as an input. As an output, the Splitter publishes one message for each single element from the original message, or combines these single messages in a bigger batch. In default, each element will be processed individually.

For example, if you want to export Customer master from Microsoft Dynamics BC, one single XML document is created internally containing data related to all the customers. Based on the filters, this document can be huge and may lead to performance issues. By using Splitter, you can split this huge chunk into smaller individual XML documents, each containing data related to one single item. These smaller chunks can be processed easily.

Also, many enterprise integration systems store message data in a tree structure which is recursive and in such case the Splitter can easily be configured to iterate through all children under a specified node and send one message for each child node. One message is processed before the splitter, several messages are processed after the splitter. The pipeline contains history/queue information for each individual message.

Items ➡️ [Splitter] ➡️ Item A | Item B | Item C...