Business Integration Solutions documentation

About: SPLITTER activity

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

Usage

Use this activity to split a large message into smaller messages, where each message is self-contained and easy to process.

Concept

The Splitter activity takes one message containing a list of repeating elements as input. As output, the Splitter publishes one message for each single element from the original message, or combines these single messages into a larger batch. By default, each element is processed individually.

For example, when you export the customer master from Microsoft Dynamics BC, one single XML document is created internally containing data for all customers. Based on the filters, this document can be large and may cause performance issues. Using the Splitter, you can split this large document into smaller individual XML documents, each containing data for one single item. These smaller documents process easily.

Many enterprise integration systems store message data in a tree structure that is recursive. In such cases, you can configure the Splitter 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...