About Display Name Key and Plain Label from 19.1

Canvas provides each Form Item with its own label text, which can be either the Display Name Key (i.e. property driven label text) or plain label (i.e., direct text). From Canvas 19.1 onwards, the display name keys and their values for forms and form items for all languages can be managed within Canvas Studio itself.

Display Name Key

The Display Name Key is a configuration-driven locale enabled label text. For displaying label text for form items through configuration, the Display Name Key must be specified and the Plain Label must be empty for the form items in the Form Designer. The actual label text for the Display Name Keys of form items can be specified using the Add Labels feature in the Form Designer.

For example, consider a bundle key 'common' that is already mapped to UK and US languages. To add label text "First Name" for the Display Name Key of ''FIRST_NAME", add 'First Name' for 'LBL_FIRST_NAME' field for UK and US languages using the Add Labels feature in Form Designer.

Plain Label

On the other hand, Plain Label is direct text, which is directly rendered without any translation irrespective of the end-user locale.

Canvas renders the Display Name Key and Plain Label properties based on the following conditions:

• If the display name key (bundle key) for the form item is not provided but the plain label is provided, then the plain label will get rendered in the application for the form item.
  
  

• If both the display name key and the plain label are provided for the form item, then the plain label will be taken as priority.
• If only the display name key is provided for a form item, then Canvas will check if the value for that key is available in the Add Labels screen and renders that value. If the value for key is not present then the caption for the form item is blank.