INSFIELD

This help page is for Studio. This information is also available for Desktop Studio.

A rectangle with a short horizontal line and a plus sign inside it.

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

Supported Script Types

A square with a line branching from it that goes to three other squares.

Generic

Email Chat Phone Voicemail Work Item SMS

Comparison of Similar Actions

The Insfield action treats strings the same as the Fieldaction, 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: newString

The resulting variable, newString, would now contain: one,two,donut,three,four,five,six. For information on removing a field, see Remfield action.

Input Properties

These properties define data that the action uses when executing.

Property

Description

Add Caption

Enter a short phrase that uniquely identifies this action in the script. The caption appears on the script canvas under the action icon. The default is the action name.

String The string you want to insert, search, or parse. This property supports variable substitution. If this value is a variable, rather than the literal string value, use curly brackets ( { } ).
Field To Insert The string to insert.
Delimiter Determines the character used to separate individual fields. The default is the pipe (|) character.
Field Index The number indicating which property to extract, starting with 1. This property is looking for a number, therefore, you do not need to use curly brackets {}.
Result Var The variable name that is created and holds returned information. For example, if the contact enters their account number as 123456, then the variable holds 123456.

Result Branch Conditions

Result branch conditions allow you to create branches in your script to handle different outcomes when an action executes.

Condition

Description

Default

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.