System Internationalization Switchover

Version

Application Scenarios

In some enterprises, different departments work with different languages. To meet the needs of each department, a multilingual system needs to be established, as shown in the following figure.

Functions

The language of the FineBI decision-making system can be switched in the following two modes:

• One-click switchover: applicable to System Management and Login Page.

• Key-value switchover: applicable to parts of the system with custom names, such as the platform directory name, platform title, and mobile server.

This document demonstrates how to switch the language of the decision-making system with a simple example.

Prerequisites

You have installed the Multilingual Solution plugin. For details, see Multilingual Language Solution Overview.

Example Description: Switch the language of decision-making system to Traditional Chinese. The language switchover is valid for the System Management page, the Test directory, sub-directories and sub-templates under this directory, the platform title, and the mobile server name. 

Method: Set the platform title and custom directory names, template names, and the mobile server name as keys, and their corresponding Chinese translation as values. After one-click platform language switchover, the language of the System Management page and custom keys will also be switched.

Preparation

Adding Directories and Templates

Log in to the decision-making system as the admin, choose System Management > Directory Management, and add directories and templates.

Modifying the Platform Title

Log in to the decision-making system as the admin, choose System Management > Appearance Configuration > Platform Style, and modify the platform title to 決策平台, as shown in the following figure.

Modifying the Mobile Server Name

Log in to the decision-making system as the admin, choose System Management > Mobile Platform > App config, and modify the server name to 行動端, as shown in the following figure.

Disabling Browser Cache

Note:

If the Disable Browser Cache option is disabled, the language of the System Management page cannot be switched. For details, see section "Internationalization Settings of System Management".

Log in to the decision-making system as the admin, choose System Management > Security Management > Security, and enable Security Headers. Click Advanced Setting and enable the Disable Browser Cache switch, as shown in the following figure.

Adding Keys and Corresponding Values

Log in to the decision-making system as the admin, choose System Management > Language Configuration. Click Add, and enter keys and their Chinese translation respectively in the text box of Key and 繁體中文, as shown in the following figure.

Note:

1. The value of Key cannot be empty or duplicate, and must be translated into at least one language. The translation should be entered in the text box of the corresponding language.
2. If you fail to add keys and values after the FineBI project is migrated to Oracle or SQL Server, you can update the driver packages of Oracle to ojdbc7.jar and SQL Server to sqljdbc42.jar.

The following table lists examples of keys and their corresponding Chinese translation.

Note:

After switchover to a certain platform language, keys without internationalized values remain original values, and keys with internationalized values will be switched to the corresponding translation.

Language Switchover

Click English in the upper right corner and select 繁體中文 from the drop-down list to switch the system language to Traditional Chinese, as shown in the following figure.

Demonstration

1. The language of both the System Management page and the platform title is switched to Traditional Chinese, as shown in the following figure.

2. After clicking Directory, you can view the names of the added directories and templates displayed in Traditional Chinese, as shown in the following figure.

3. The app page displayed after you log in to the decision-making system through the data analysis app, as shown in the following figure.

• The names of the added directories and templates are displayed in Traditional Chinese.

Language Configuration

Key-Value Management

Log in to the decision-making system as the admin, and choose System Management > Language Configuration to enter the internationalization settings.
You can view, add, delete, edit, search, batch-import, batch-export, back up, and roll back keys and values on this page.

Note:

1. Remarks are not covered in the search range.
2. The Clear List button only appears when all keys are selected by ticking Key.

Key-Value Batch Import

1. Create an Excel as the data source. The headers of the Excel must follow the specified format shown in the following figure. Otherwise, the import fails.

2. Click Import in the decision-making platform and select the data source, as shown in the following figure.

Note:

The Multilingual Solution plugin of versions earlier than 2.0.7 only supports Excel in XLS format, while later versions support Excel in XLS and XLSX format.

Key-Value Batch Export

Choose System Management > Language Configuration > Export > Export Excel to export keys and values in batches, as shown in the following figure.

Backup and Rollback

Click Backup. A backup success prompt pops up, indicating that the current keys and values have been backed up.
Click Rollback. A backup restoration success prompt pops up, indicating that the backup has been restored, as shown in the following figure.

Platform Language Preference

Log in to the decision-making system as the admin, and choose System Management > Language Configuration > More Settings to set the platform language preference, as shown in the following figure.

• Platform Language Preference: The system will be displayed in the preferred language for every user upon login. The setting will take effect after server restart.

• Setting of Platform Supported Language: You can select languages supported by the system.

Note:

1. The system supports Simplified Chinese, Traditional Chinese, English, Japanese, and Korean.
2. To use the language switchover function on the login page, the platform language preference must be set to Simplified Chinese.

Internationalization Settings of System Management

Log in to the decision-making system as the admin, choose System Management > Security Management > Security. Then enable Security Headers, click Advanced Settings, and enable Disable Browser Cache.
Click English in the upper right corner and select a language from the drop-down list to switch the language of the System Management page.

Internationalization Settings of the Login Page

Note:

To use the language switchover function on the login page, the platform language preference must be set to Simplified Chinese. For details, see section "Platform Language Preference".

After internationalization settings, you can switch the language through the drop-down list at the bottom of the login page, as shown in the following figure.