Updating State enumerations for integrations and custom UIs

If you are upgrading from NexJ Contact version 7.2 or earlier, you must update enumeration values used in integrations or transformations with external sources and in custom UIs.

Note: This is a developer task and must be performed in NexJ Studio by a person with access to the model.

State enumeration values have been updated to support all countries. State enumeration values now associate administrative divisions, such as states or provinces, with the country to which they belong. Now enumeration values are prefixed with the country code. For example, the State enumeration value for New York state is now USA_NY. Prior to this release, the enumeration value was NY. Values have been updated in both the value and behaveAsValue properties for enumerations.

For backwards compatibility, the value of the value property for enumerations has been moved to the shortCaption property. For example, the value of the shortCaption property for New York state is now NY.

Note: Upgrade options vary depending on how you reference enumeration values in your project.
To update State enumerations for integrations and custom UIs:
  1. To update State enumerations used in integrations or transformations, if your project references the value property for State enumerations, replace the value property with the shortCaption for each enumeration referenced in the integration or transformation.
  2. If the collectionValue property in a UI bind for a control references the value property, replace the value property with the shortCaption property.
State enumeration values have been updated for your project.
Alternatively, consider writing upgrade steps, for example SQL upgrade steps, to amend affected records with the country code prefix in the database. If you write your own upgrade steps, then you do not need to update State enumerations used in integrations or transformations.