Split shape

Introduction

The split shape is used to split out a given payload element. When data is split, the specified element (including any nested elements) is extracted for onward processing.

For example, your process flow might receive customer data from a source connection, but you need to send address details to a different endpoint. In this case, you'd use the route shape to create two different routes, mapping just customer data down one, and splitting out addresses for the other.

A single incoming payload for any process flow shape should not exceed 500MB.

We recommend processing multiple, smaller payloads rather than one single payload (1000 x 0.5MB payloads are more efficient than 1 x 500MB payload!).

For payloads up to 500MB, consider adding a flow control shape to batch data into multiple, smaller payloads. Payloads exceeding 500MB should be batched at source.

Adding & configuring a split shape

Show me

Step 1 In your process flow, add the split shape in the usual way:

Step 2 Select a source integration and endpoint to determine where the incoming payload to be split originates:

Step 3 Move down to the level to split section and use the dropdown data path to select the required data element to split - for example:

Remember - any data (including nested data) within the selected element will be split out into a new payload.

Step 4 If required, you can add a wrapper key. This wraps the entire payload in an element of the given name - for example:

...would wrap the payload as shown below:

Step 5 Save the shape.