String connector

Operations

`concatenate`

Joins an array of strings together with an optional separator.

Parameters

Parameter	Type	Required	Default	Description
`strings`	string[]	No	`[]`	The array of strings to concatenate
`separator`	string	No	`""`	The separator to insert between strings

Examples

// Basic concatenation
{ "operation": "concatenate", "data": { "strings": ["Hello", "World"] } }

// Output
{ "result": "HelloWorld" }

// With separator
{ "operation": "concatenate", "data": { "strings": ["Hello", "World"], "separator": " " } }

// Output
{ "result": "Hello World" }

// With custom separator
{ "operation": "concatenate", "data": { "strings": ["apple", "banana", "cherry"], "separator": ", " } }

// Output
{ "result": "apple, banana, cherry" }

`split`

Splits a string into an array of substrings based on a delimiter.

Parameters

Parameter	Type	Required	Default	Description
`text`	string	No	`""`	The string to split
`delimiter`	string	No	`""`	The delimiter to split on

Examples

// Split by space
{ "operation": "split", "data": { "text": "Hello World", "delimiter": " " } }

// Output
{ "result": ["Hello", "World"] }

// Split by comma
{ "operation": "split", "data": { "text": "apple,banana,cherry", "delimiter": "," } }

// Output
{ "result": ["apple", "banana", "cherry"] }

// Split into characters (empty delimiter)
{ "operation": "split", "data": { "text": "Hello", "delimiter": "" } }

// Output
{ "result": ["H", "e", "l", "l", "o"] }

`substring`

Extracts a portion of a string between specified indices.

Parameters

Parameter	Type	Required	Default	Description
`text`	string	No	`""`	The source string
`start`	number	No	`0`	The starting index (zero-based)
`end`	number	No	End of string	The ending index (exclusive)

Examples

// Extract from start index to end
{ "operation": "substring", "data": { "text": "Hello World", "start": 6 } }

// Output
{ "result": "World" }

// Extract specific range
{ "operation": "substring", "data": { "text": "Hello World", "start": 0, "end": 5 } }

// Output
{ "result": "Hello" }

// Extract middle portion
{ "operation": "substring", "data": { "text": "abcdefgh", "start": 2, "end": 6 } }

// Output
{ "result": "cdef" }

`trim`

Removes leading and trailing whitespace from a string.

Parameters

Parameter	Type	Required	Default	Description
`value`	string	No	`""`	The string to trim

Examples

// Trim whitespace
{ "operation": "trim", "data": { "value": "  Hello World  " } }

// Output
{ "result": "Hello World" }

// Trim tabs and newlines
{ "operation": "trim", "data": { "value": "\n\t  Hello  \t\n" } }

// Output
{ "result": "Hello" }

`toLowerCase`

Converts a string to lowercase.

Parameters

Parameter	Type	Required	Default	Description
`value`	string	No	`""`	The string to convert

Examples

// Convert to lowercase
{ "operation": "toLowerCase", "data": { "value": "Hello World" } }

// Output
{ "result": "hello world" }

// Mixed case input
{ "operation": "toLowerCase", "data": { "value": "HELLO world 123" } }

// Output
{ "result": "hello world 123" }

`toUpperCase`

Converts a string to uppercase.

Parameters

Parameter	Type	Required	Default	Description
`value`	string	No	`""`	The string to convert

Examples

// Convert to uppercase
{ "operation": "toUpperCase", "data": { "value": "Hello World" } }

// Output
{ "result": "HELLO WORLD" }

// Mixed case input
{ "operation": "toUpperCase", "data": { "value": "hello WORLD 123" } }

// Output
{ "result": "HELLO WORLD 123" }

`uuid`

Generates a random UUID (Universally Unique Identifier) v4.

Parameters

This operation takes no parameters.

Examples

// Generate UUID
{ "operation": "uuid", "data": {} }

// Output
{ "result": "550e8400-e29b-41d4-a716-446655440000" }

Note: Each invocation generates a new random UUID. The example output above is illustrative; actual output will vary.

Using with template variables

String operations can use template variables for dynamic values:

{
  "operation": "concatenate",
  "data": {
    "strings": ["Hello, ", "{{ params.userName }}", "!"],
    "separator": ""
  }
}

{
  "operation": "split",
  "data": {
    "text": "{{ params.csvData }}",
    "delimiter": ","
  }
}