INSFIELD
                                                        This help page is for Studio. This information is also available for Desktop Studio.
| 
                                                                         
                                                                              | 
                                                                    
                                                                         Inserts a new field into a delimited string list array, separated by a pipe symbol (|).  | 
                                                                
Supported Script Types
| 
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                
| 
                                                                         Generic  | 
                                                                    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.   | 
                                                            
| 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. |