Set case and accent sensitivity on a per-column basis
Set locale text match to provide case and accent sensitivity when searching the text of table columns. The default behavior for text searching in table columns is insensitive to case and accent (diacritic) variations, but you can enforce sensitivity using locale text match.
Overview of locale text match
By default, text searching in table columns is insensitive to case (example: A vs. a) and accent or diacritic (example: A vs. Å).
As an admin, you can modify this behavior for the fields you specify by setting the column attribute i18n_locale_text_match and a sys property com.glide.db.ui_i18n_locale_text_match. When set to true, text search on the column retrieves only exact matches for case and accent.
Locale text match is available from Zurich Patch 9 and Australia Patch 2.
- Setting locale text match overrides the collation of SQL queries for the specific column.
- You can't set the i18n_locale_text_match column attribute when the following attribute is set on the same column: i18n_session_language_sortable or if property com.glide.db.session_language_collation_feature=true. For more information see Sorting according to the session language.
- Test the case and accent sensitive behavior thoroughly. When the i18n_locale_text_match column attribute is set, the behavior is applied to all queries including ACLs, business rules, and so forth.
Setting the column attribute i18n_locale_text_match
- With the admin role, navigate to sys_dictionary.list.
- Search for the name of your table and the name of the column to which you want to add this attribute.
- Open the dictionary entry, and confirm the column's Type. This attribute can be added to String, Translated Text, or Translated Field types.
- In the Attributes field of the column, add i18n_locale_text_match=true. Use a comma separator without spaces. (You may need to switch to the Advanced view of the record to see the Attributes field).
- As an alternative to the previous step, open the Attributes tab in Related Links, then select New. In the Attributes field search for locale text match, then set the Value field to True.
- Select Update or Submit.
Other methods for locale text match
- GlideRecord: setLocaleTextMatch (Boolean isLocaleTextMatch)
- Where: Used in scripts, such as for background transactions.
- Use case: Temporarily activate or deactivate locale text match (case and accent sensitivity) for a specific GlideRecord query
- URL parameter: sysparm_locale_txt_match
- Where:
- Add
sysparm_locale_txt_match=trueorsysparm_locale_txt_match=falseas an extra parameter in a URL. - Table API. For information see Explore the REST API for a table.
- Add
- Use case: When the parameter is added, activate or deactivate locale text match (case and accent sensitivity) for queries that display data in platform lists.
- Where:
- Global property: com.glide.db.ui_i18n_locale_text_match
- Where: Create a property in sys_properties, if it doesn't exist already.
Name: com.glide.db.ui_i18n_locale_text_match.
Type: true | false.
Value: either true or false according to your business requirements. For text searches in tables in the product UI, both this property and the column attribute should be set to true.
- Default: false
- Use case: Activate or deactivate locale text match (case and accent sensitivity) for queries that display data in the platform lists.
- Where: Create a property in sys_properties, if it doesn't exist already.
- URL parameter: sysparm_locale_txt_match (highest priority).
- Global property: com.glide.db.ui_i18n_locale_text_match (lowest priority).