StringBuilder connector methods

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 1 minute to read

    • The StringBuilder connector methods enable you to create, append, update, replace, or remove strings in your automation workflow in RPA Desktop Design Studio.

    Append

    Adds string to an existing string. You can create multiple strings by using multiple copies of the method. To view the output, use the ToString method.
    Note:
    The method doesn't insert a line between the strings.
    Table 1. Append method parameters
    Parameter name Description Data Port type Data type
    Value The string to be appended to the existing content.
    Example
    Existing string: "Hello"

    Value: " World!"

    Output: Hello World!

    		 Data In String
    Input
    Value

    AppendLine

    Adds a string followed by a newline character (\n) automatically. When you add multiple strings using multiple copies of the method, it inserts a line between the strings. It functions exactly like the Enter key on a Microsoft Word document. To view the output, use the ToString method.
    Input
    Value
    Table 2. AppendLine method parameters
    Parameter name Description Data Port type Data type
    Value String to append followed by a line break.
    Example
    Existing string: "Hello"

    Value: "World!"

    Output: Hello

    World!

    		 Data In String

    Replace

    Replaces a string with a string that you specify in both the Append and AppendLine methods.

    Input
    OldValue
    NewValue
    Table 3. Replace method parameters
    Parameter name Description Data Port type Data type
    OldValue Existing string that is replaced with a string specified in the NewValue field.
    Example
    OldValue: User
    		 Data In String
    NewValue String that replaces the OldValue string.
    Example
    NewValue: Abel Tutor
    		 Data In String

    Clear

    Clears the string content in the methods.

    ToString

    Returns the output of the Append and AppendLine methods.
    Outputs
    Return
    Table 4. ToString method parameters
    Parameter name Description Data Port type Data type
    Return Output that is returned after the execution of the Append and AppendLine methods. For examples, see Append and AppendLine parameters. Data Out String

    Configure inputs for the parameters

    To enter inputs for parameters, see Configure port properties.