Create User Field

Creates a custom data definition through Proactive XS for CXone.

Supported Script Types

Phone

Properties

Details Property
Name Enter the name you want to give your source. Create Prospect v.1 used to carry this name; however, mapping requires that field be removed and stored here.
DataType The type of data to return, such as a string, phone, Boolean, int, decimal, date, time, etc.
DefaultValue The value you would provide to any record without a matching mapping. Cannot exceed 200 characters.
Associations Applies only to the phone data type. A correlation between a phone data type and another custom data definition. Make sure the custom data definition is the same data type as the associated field.

Branches

Branch Details
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 other branches are not defined.
Error Path taken when the action fails to execute properly.
FieldInUseByProcessingFilter Path taken if there is an attempt made to change or remove a value currently in use by a filter.
InvalidDataType Path taken if the data type provided does not match a supported data type.
NoNameProvided Path taken if the Name property is blank.
DataTypeMismatch Path taken if the subfield given has a different data type than the expected data type. For example, a Date data type rather than a Boolean may be given to compliance.
UserDefinedFieldNotFound Path taken if the subfield is mapped to a non-existent field.
InvalidSubField Path taken if fields requested in the properties cannot be interpreted by CXone.
DefaultValueDoesntMatchDataType Path taken if the specified default value does not match the specified data type. For example, if the default value is a string, but the data type is an integer.
DataTypeDoesntSupportDefaultValue Path taken if the data type does not support the default value, for example, the phone data type.
FieldExceededLength Path taken if the Name property is longer than 255 characters.
InUseAsSubtype Path taken if the field is currently in use as a subtype of another field, specifically if the data type is being changed.

Tips & Tricks

  • Create User Field is for use with Proactive XS only.
  • Any data definition type you can create in CXone can also be created through Create User Field.

Phone Script Example Using Create User Field

The script shown below sets all the paths for Create User Field, which enables you to create a new custom data definition.

Double-click the Snippet action to view the snippet properties. Click here to view these properties in a text view.

Would you like to download this script?