Managing Display Names for Forms
Prerequisites
When adding display names for a new language, a new entry (record) must be added for that language with the correct language ID (LANG_ID column) in the LANGUAGEMASTER table in the Canvas schema. For the changes to get applied, users must choose their primary language as the preferred language in the functional application, Modelhouse. A sample entry in the LANGUAGEMASTER table for the Arabic language is shown for reference:
APPLICATION_ID | LANG_ID | LANGUAGE | CREATED_DATE | CREATED_BY | UPDATED_DATE | UPDATED_BY | DIRECTION |
---|---|---|---|---|---|---|---|
MODELHOUSE | ar_SA | ARABIC | 2019-12-29 | MAKER | RTL |
Adding an entry for the new language in the LANGUAGEMASTER table is mandatory, without which that language will not appear in the functional application (e.g. Preferences tab in Modelhouse).
To manage the display names of forms, perform the following steps.
Let's assume that the form with the Form Id, CUSTOMER_INFORMATION has been created using Canvas Studio.
- Open the form in the Form Designer in Canvas Studio.
- Click a field on the form. For instance, click the Text Field form item.
Click the Plain label icon.
By default, the name of the form item appears in the Plain label field. In the following screen shot, the word, 'NAME' has been assigned as the text of Plain Label.If language specific labels have to be rendered, then the Display Name Key has to be used instead of the Plain label. If Plain label is present for a form item, it takes more precedence. To enable Add labels, remove the default or assigned text from the Plain label field.
- After removing the name from the field of Plain label, click Display Name Key icon.
A text field appears. Enter the display name key in the text field and press Enter. For instance, the word NAME can be used.
In the text field of Display Name Key, blank spaces should not be used. Symbols like hyphen (-) and underscore (_) can be used.
Once you have applied changes with Display Name Key to all the form items that you have used in your form, proceed to click Add Labels icon.
The Add labels screen will get enabled, if there is at least one form item with a display name key.
The Resource Bundle Entries Page appears.
The Bundle Name is taken from the form’s default bundle name. You can change the default bundle name by using the Form ribbon in the Form Designer.
The Language drop-down box allows you to choose your preferred language. For new languages, refer the Prerequisites mentioned above in the procedure.- Select your desired Language from the Language drop-down box.
- In the Form Item Labels tab, click the Phrase for fields and enter the display names. You can choose any of the fields, for which you wish to modify the display names. The following screen shot showcases the new display names.
- After changing the display names for the form fields, click Save.
The Resource Bundle data gets saved successfully.
- Click OK.
- Click Save icon to save the form.
After you save the form, a successful confirmation message appears, with a reference number.
Let's assume that the form is already mapped to the widget, Account Holders' Information, which, in turn, is mapped to the workspace, titled as Form in the functional application (e.g. Modelhouse). The following screen shot serves as a good illustration of the output in the functional application, Modelhouse.
The following table illustrates the different form types, which possess the Plain label configuration. Certain form types listed in the table do not possess the Plain label functionality.
S.No | Form Items | Plain Label |
---|---|---|
1 | Text Box | Yes |
2 | Text Area | Yes |
3 | Password Field | Yes |
4 | Date | Yes |
5 | Spinner Field | Yes |
6 | Amount Field | Yes |
7 | HTML Editor | Yes |
8 | Checkbox Group | Yes |
9 | Radio Group | Yes |
10 | Combo | Yes |
11 | Icon Combo | Yes |
12 | Auto Suggest | Yes |
13 | Item Selector | Yes |
14 | Lookup | Yes |
15 | Independent Lookup | Yes |
16 | Color Picker | Yes |
17 | Slider Field | Yes |
18 | Toggle | Yes |
19 | Checkbox | Yes |
20 | Button Field | Yes |
21 | Upload Panel | Yes |
22 | Title | Yes |
23 | Label Item | Yes |
24 | Logo | No |
25 | Hyperlink | Yes |
26 | Image Picker | Yes |
27 | Field Set | Yes |
28 | Form Composite | Yes |
29 | Panel | Yes |
30 | Tab Panel | No |
31 | Image Panel | No |
32 | Empty Cell | No |
33 | Line | No |
34 | Hidden | No |
35 | Empty Row | No |
36 | Conditional Mandatory Text | No |
37 | Mandatory Text | No |
38 | Info Panel | Yes |
39 | Widget | No |
40 | Form | No |
41 | Multi Form | No |
42 | Tree View | Yes |