FIELD

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

A rectangle with a short horizontal line in it.

Extracts portions of a string based on a separator character known as the delimiter. For example, an email address always has two parts: an account name and a host name separated by an @. With the delimiter set to @, the account name is the first field and the host name is the second field in the address.

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

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 ( { } ).
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 {}.
Store Field In Name of a variable to receive the extracted property.
Store Count In This property is the number of items in an array. This number will always at least be 1.

Result Branch Conditions

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.

Tips & Tricks

With CXone Mpower, a delimited set of data can be treated as a list or as an array. CXone Mpower treats the pipe symbol (|) as a standard delimiter for lists and arrays. The following example will extract the word “three” from a pipe delimited list of words and save it as the variable named F1:

  • String: one|two|three|four|five
  • Delimiter: |
  • Field Index: 3
  • Store Field In: F1
  • Store Count In: FC