Interface Asset - Text Manipulation

    Description

    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.

    TextManipulation-DA.jpg

    Properties, Triggers & Actions

    Properties

    • 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.

    TextManip-IA.jpg

    Triggers

    Text Manipulation

    • Output value changed: raised when the Output text value has changed

    Comparators

    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

    Actions

    • 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.