split | Itential

The split task splits a string into an array of substrings at each occurrence of a given separator. The original string is not changed.

Potential use case

A comma-separated list of ticket numbers is provided to the automation. Use the split task to create an array of ticket numbers for subsequent processing in the workflow.

Properties

Input	Type	Description
`str`	String	Required. The string to split.
`separator`	String	The point where each split occurs. Can be a single or multiple characters. If omitted, the entire string becomes a single array element. If an empty string (`""`), every character is separated.
`limit`	Number	The number of splits to make. Items after the split limit are not included in the returned array. Can be zero or a non-negative integer.

Output	Type	Description
`splitArray`	Array	An array of strings formed by splitting the original string at each separator occurrence.

Example

The incoming str variable is required.

split task with str mapped to a reference variable

The variables are set before running the workflow. In this example, the string is "Hello World", the separator is the letter "o", and the limit is 3.

Job variable setup showing the string Hello World, separator o, and limit 3

After the workflow runs, the output is visible in Task History (accessed from Jobs in Operations Manager). Three splits were made at each occurrence of "o". Note that split also recognizes and includes whitespace.