Definition and Usage
Creates a list containing the substrings of a text that is separated by a specified delimiter or a regular expression. This command breaks down a text string into multiple parts based on a chosen separator and stores the results in a list variable.
Parameter Values
Input parameters
Parameter | Description | Possible Values | Required | Options / Notes |
Text to split | Enter text or select a variable containing the text | - | Yes | - |
Delimiter type | Specify whether to use a standard or custom delimiter | Space, Tab, Line break, Custom delimiter | Yes | - |
Custom separator | Enter the character(s) used as a delimiter | - | Yes (if Custom delimiter is selected) | - |
Remove spaces from the split result | Specify whether remove space(s) when splitting the text | True/False | No | Removes leading and trailing spaces from each element after splitting |
Use RegEx | Specify whether the delimiter will be a regular expression | True/False | No | A regular expression creates a range of possibilities for the delimiter; For example, '\d' means that the delimiter could be any digit |
Error handling
Parameter Name | Description |
Throw error & stop | When an error occurs, the action will trigger an error and stop the execution of the entire app. |
Retry command | If an error occurs, the action will retry the command in an attempt to resolve the issue and continue the process. |
Ignore error & continue | When an error occurs, the action will be ignored, and the workflow will continue without interruption. |
Variables produced
This action produces a list variable containing all the substrings after splitting the input text according to the specified delimiter.
Using Variables in Conditions
You can use the {x} icon to insert variables from previous steps into any parameter field. The output list variable can be used in subsequent actions that require list manipulation or iteration.
Notes
When using RegEx as a delimiter, make sure the expression is properly formatted to avoid unexpected results.
Empty elements might be created if there are consecutive delimiters in the input text.
The "Remove spaces" option is useful when working with data that might contain unwanted whitespace.
For complex text parsing needs, consider combining this command with other text manipulation commands.