The Text Manipulation interface asset performs a variety of operations on text values. Uses include:
- Dynamically building a URL composed of multiple parameters:
http://myWebsite.com/service?param= and [someValue] --> http://myWebsite.com/service?param=[someValue]
- Formatting names read in from a data source such as setting the first letter of each name to uppercase:
john doe --> John Doe
- Replacing the contents of a sentence with a choice made by the user:
You have selected XX products --> You have selected 3 products
The following image shows an example of how one might use the Text Manipulation interface asset.
- Original text: the text on which you will apply one of the available actions
The property below is a read-only property, thus only visible through a binding
- Output text: contains the result of the action applied to the Original text. This property's value is read-only and thus only available through binding.
- Output value changed: raised when the Output text value has changed
Each of the following triggers are raised with the Output text value has changed the condition is true
NOTE: Only if the Output text is comprised solely of numbers can the number-specific comparators below be used. However, even a string of numbers can be treated like text.
- If treating the Output text value as text
- Output value equals
- Output value does not equal
- Output value contains
- Output value does not contain
- Output value matches
- Output value does not match
- Output value starts with
- Output value does not start with
- Output value ends with
- Output value does not end with
- If treating the Output text value as a number
- Output value is greater than or equal to
- Output value is greater than
- Output value is less than or equal to
- Output value is less than
- Clear: Clears both the Original text and Output text values.
- Concatenate: Adds new text onto the end of the original text.
- Item at: Gets the item at a specified index. Items are identified by the selected separator. For example, by using a space as the separator, you can extract a word from a sentence.
- Replace: Replaces all instances of specified text with new text. For example replace "XX" with the value entered by a user in a Text Input control.
- Substring: Extracts a substring from the original text. For example, extract the first 30 characters from the original text.
- To lowercase: Converts the original text to lowercase letters.
- To uppercase: Converts the original text to uppercase letters.