INSFIELD

Inserts a new field into a delimited string list array, separated by a pipe symbol (|).

Supported Script Types

Generic Email Chat Phone Voicemail Work Item

Properties

String

This property is the String and contains multiple fields separated by a delimiter.

This property can be a variable.

FieldToInsert
This property is the String to insert.
Delimiter
This property is the character to separate each property.

The default delimiter is a pipe (|) character.

FieldIndex

This property is an Index where the new string will be inserted starting with 1.

Because this is a number property, do not use curly brackets {}.

ResultVar
This property is the name of the variable to receive the new string list.

Branches

Default
The Default branch condition will always be used.

Tips and Tricks

  • The INSFIELD action treats strings the same as the FIELD action, but rather than reading the string, INSFIELD inserts a new member into the string, for example:
    • String: one,two,three,four,five,six
    • Field To Insert: donut
    • Delimiter: ,
    • Field Index: 3
    • Result Var: New String

    The resulting variable, New String, would now contain: one,two,donut,three,four,five,six. For information on removing a field, see REMFIELD.