Changing the label of a button or an option
As a standard, the beqom v10 application comes fully localized in twelve languages: English, French, German, Italian, Spanish, Brazilian Portuguese, Turkish, Polish, Chinese (Simplified), Chinese (Traditional), Japanese and Russian.
You can however change the standard localization of any label, button, etc. in the interface in order to customize the application according to your company standard or your preferences.
This administrative operation is performed in the custom localization area.
This is a tip message.
The customization of the application localization is performed in the Admin Portal interface, but the procedure below is applicable to both the Web Application and the Admin Portal interfaces.
In the use case examined in this article, we will be changing the name of the "Analysis" component in the Web Application to "Reports".
The following table details the order of the steps to be performed to customize the localization in the v10 application:
| Step # | Description |
|---|---|
| 1. | Disable application localization. |
| 2. | Locate the key(s) corresponding to the label(s) to be modified. |
| 4. | Reapply the localization. |
| 3. | Change the label in Admin Portal. |
Disabling the application localization
You can disable the application localization from two either interface of the v10 application, Web App or Admin Portal. When the application localization is disabled, the technical keys behind the interface labels are visible instead of the normal text. Disabling the localization enables you to pinpoint exactly the localization key to look for when customizing the localization.
Disabling the application localization from Web App
To disable the application localization from the Web App interface of v10, proceed as follows:
Open the ADMIN component of Web App, and then click Localization, under the General section of the component menu.
Toggle the switch to Disable.
Click Save in the lower-right corner of the application window.
Disabling the Application Localization from Admin Portal
To disable the application localization from the Web App interface of v10, proceed as follows:
Open the (Undefined variable: CompoVariables_AP.Admin) of Admin Portal and then navigate to Technical Admin > Settings Management.
Check the Disable Localization box located in the Global section of the page.
Click the save icon located in the lower-right corner of the page.
Changing the label of a standard UI element
To change the label of a standard user interface element, proceed as follows:
After having disabled the localization, in the application, navigate to the item that you want to rename (whether it is in the Web App or in the Admin Portal). In our example, we are renaming theAnalysis in Web App to "Reports". The key that we need to change is BTN_main_nav_analysis.
Re-enable the localization using either of the procedures described in Disabling the Application Localization.
Stay in the (Undefined variable: CompoVariables_AP.Admin), and then go Technical Admin > Localization > Custom Localization. The grid containing all the localization keys currently used in the system is displayed. The table contains records for all standard application labels. You don't need to create new items.
Search, in the grid, for the key that you want to change. Enter the name of the key in the Name field of the grid.
Locate the key record (culture) corresponding to the value that you want to change (as a standard, there are seven records for each key, one for each of the standard languages) as illustrated in the following figure:
Custom localization table in Admin Portal
Perform your changes and then click Save in the toolbar located at the bottom of the grid. The modified keys are automatically updated in the application after the page is refreshed. Clear your browser cache in order to display the translations correctly.
Navigate to the item that you changed to check that the translation has been modified, as illustrated in the following figure:
Modified label in the application