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?