---
title: "Set up the Splitter activity"
slug: "bc-set-up-the-splitter-activity"
updated: 2026-06-25T07:59:18Z
published: 2026-06-25T09:59:17Z
canonical: "docs.staedean.com/bc-set-up-the-splitter-activity"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staedean.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up the Splitter activity

Use the Splitter activity to break a composite message into a series of individual messages, where each message contains data related to one item.

## Steps

1. Create a connection and insert the element **SPLITTER**.
2. On the elements line, select **Edit**.
3. On the **Message Splitter Setup** page, fill in the following fields:

| Field | Description |
| --- | --- |
| Document Type | Select the document type: either **Internal** or **External**. |
| Document No. | Based on the document type, select the document. |
| Do you want to split at a specific node path? | When selected, you must also specify the **Split Node Path** field. See also the [Examples](/business-central/docs/bc-set-up-the-splitter-activity#examples). |
| Split Node Path | Provide a specific node path where the document splits. |
| Split Batch Size | Provide a batch size for splitting the source file. By default, the **Splitter** splits the source file on the first node under the root node. For example, splitting one XML file containing 1,000 sales orders generates 1,000 individual XML files. Setting a batch size of 250 generates four XML files with 250 sales orders each. |
| Post with Job Queue | Select this field to process the connection using the job queue with a specific category. Further processing of messages always runs in a background (job queue) session. See [Scheduler](/business-central/docs/bc-set-up-the-scheduler-activity) for more information. |
| Job Queue Category Code | Specifies the code of the job queue category to which the job queue entry belongs. Select the field to choose a code from the list. |

1. Select **Check Configuration** to see if there are Anywhere Mobility Solutions configuration errors.
2. Select **OK**.

![Splitter Setup](https://cdn.document360.io/da662430-6a41-47b1-8c7e-7e4ac37a9756/Images/Documentation/BIS_SplitterSetup.png)

## Examples

Given the following document definition:

```plaintext

    Sub node 1 value
    Sub node 2 value
    
        Sub node 3 value
        Sub node 4 value
        Sub node 5 value
    
```

### Example 1

**Do you want to split at a specific node path?** set to false. This generates the entire document.

### Example 2

**Do you want to split at a specific node path?** set to true and **Split Node Path** set to `SubNode1`:

```plaintext
Sub node 1 value
```

### Example 3

**Do you want to split at a specific node path?** set to true and **Split Node Path** set to `Header/Header`:

```plaintext

    Sub node 3 value
    Sub node 4 value
    Sub node 5 value
```

### Example 4

**Do you want to split at a specific node path?** set to true and **Split Node Path** set to `Header/Header/SubNode`. This results in three messages:

```plaintext
Message 1:
Sub node 3 value
Message 2:
Sub node 4 value
Message 3:
Sub node 5 value
```

Setting the batch size to 2 generates two messages:

```plaintext
Message 1:

    Sub node 3 value
    Sub node 4 value

Message 2:

    Sub node 5 value
```

## Related

- [SPLITTER activity](/bc-splitter-activity.md)