Text

Purpose

The Text Operator enables working with text and templates. It provides functionality for text manipulation, formatting, and template rendering, allowing for dynamic content generation and text transformation.

Use Cases

• Generating dynamic content from templates
• Formatting text for display or processing
• Extracting specific parts of text
• Converting text between different formats
• Creating URL-friendly slugs from text
• Normalizing text input
• Manipulating text case (uppercase, lowercase, etc.)
• Finding and replacing text patterns
• Processing user input
• Preparing text for database storage

Supported Operations

render-template

Renders a template with provided values using Mustache templating.

Input Parameters

• template (string): The template string with Mustache placeholders
• values (object): The values to use for template rendering

Output

Returns the rendered template as a string.

Example

{
  "template": "Hello, {{name}}! Welcome to {{company}}.",
  "values": {
    "name": "John Doe",
    "company": "SyncMyOrders"
  }
}

trim-and-normalize

Trims whitespace and normalizes text by removing extra spaces.

Input Parameters

• text (string): The text to trim and normalize
• removeExtraSpaces (boolean, optional): Whether to replace multiple spaces with a single space

Output

Returns the trimmed and normalized text.

Example

{
  "text": "  This   text   has   extra   spaces.  ",
  "removeExtraSpaces": true
}

case-conversion

Converts text to a different case format.

Input Parameters

• text (string): The text to convert
• conversion (string): The type of conversion to perform (UPPER, LOWER, CAPITALIZE, TITLE_CASE)

Output

Returns the text in the specified case format.

Example

{
  "text": "this is a sample text",
  "conversion": "TITLE_CASE"
}

find-and-replace

Finds and replaces text patterns.

Input Parameters

• text (string): The text to process
• find (string): The text to find
• replace (string): The text to replace it with
• replaceAll (boolean, optional): Whether to replace all occurrences or just the first one

Output

Returns the text with replacements applied.

Example

{
  "text": "The quick brown fox jumps over the lazy dog",
  "find": "fox",
  "replace": "cat",
  "replaceAll": true
}

extract-first-line

Extracts the first line from text.

Input Parameters

• text (string): The text to process
• trimResult (boolean, optional): Whether to trim the result

Output

Returns the first line of the text.

Example

{
  "text": "First line\nSecond line\nThird line",
  "trimResult": true
}

extract-first-word

Extracts the first word from text.

Input Parameters

• text (string): The text to process
• trimResult (boolean, optional): Whether to trim the result
• delimiter (string, optional): The delimiter to use for splitting words (default is space)

Output

Returns the first word of the text.

Example

{
  "text": "First word second word third word",
  "trimResult": true,
  "delimiter": " "
}

split-and-join

Splits text by one delimiter and joins it with another.

Input Parameters

• text (string): The text to process
• splitBy (string): The delimiter to split by
• joinWith (string): The delimiter to join with
• trimParts (boolean, optional): Whether to trim each part before joining

Output

Returns the text split and rejoined with the specified delimiters.

Example

{
  "text": "apple,orange,banana,grape",
  "splitBy": ",",
  "joinWith": " | ",
  "trimParts": true
}

remove-characters

Removes specified characters from text.

Input Parameters

• text (string): The text to process
• characters (string): The characters to remove
• removeSpaces (boolean, optional): Whether to also remove spaces

Output

Returns the text with specified characters removed.

Example

{
  "text": "Hello, World! 123",
  "characters": ",.!123",
  "removeSpaces": false
}

substring-extraction

Extracts a substring from text.

Input Parameters

• text (string): The text to process
• startIndex (integer): The starting index (0-based)
• endIndex (integer, optional): The ending index (exclusive)
• length (integer, optional): The length of the substring to extract (alternative to endIndex)

Output

Returns the extracted substring.

Example

{
  "text": "The quick brown fox jumps over the lazy dog",
  "startIndex": 4,
  "length": 5
}

collapse-or-expand-lines

Collapses multiple lines into one or expands a single line into multiple lines.

Input Parameters

• text (string): The text to process
• mode (string): The mode to use (COLLAPSE or EXPAND)
• delimiter (string): The delimiter to use for collapsing or expanding

Output

Returns the text with lines collapsed or expanded.

Example

{
  "text": "Line 1\nLine 2\nLine 3",
  "mode": "COLLAPSE",
  "delimiter": " | "
}

slugify

Converts text to a URL-friendly slug.

Input Parameters

• text (string): The text to convert to a slug
• lowercase (boolean, optional): Whether to convert the slug to lowercase
• separator (string, optional): The separator to use between words (default is ”-“)

Output

Returns the slugified text.

Example

{
  "text": "This is a Sample Title! 123",
  "lowercase": true,
  "separator": "-"
}

Notes

• The Text Operator uses Mustache for template rendering
• Text operations are performed using Java’s string manipulation methods
• Case conversion supports various formats (UPPER, LOWER, CAPITALIZE, TITLE_CASE)
• The slugify operation removes special characters, replaces spaces with separators, and normalizes text
• All operations handle null or empty input gracefully
• The operator is useful for preparing text for display, storage, or further processing
• Template rendering can use complex objects with nested properties