Platform Multilingual Switchover

Version

Application Scenario

In an enterprise, to avoid departments meeting their requirements through multiple systems with different languages, you want to achieve the effects of multilingual displays in a single system. The effects include switching not only the system page language of the decision-making platform but also the platform directory name, platform title, and mobile platform server.

Function Description

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

One-click switchover of the system page language: The pages include the system management page, the login page, the BI tool page, the public data page, the page of my analysis, and the recycle bin page.

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

Note:

1. You can switch only among the five languages: Simplified Chinese, Traditional Chinese, English, Japanese, and Korean.

2. The multilingual switchover of the dashboard content is not supported. For details about dashboard language switchover, see Dashboard Multilingual Switchover.

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

Prerequisite

You have obtained the plugin at https://community.finereport.com/plugin/?id=117.

For details about how to install the plugin in the designer, see Plugin Management.

Example:

Switch the language of the decision-making platform to Japanese. The language switchover is valid for the System Management page, the Test directory, subdirectories and sub-templates under this directory, the platform title, and the mobile platform server name.

Implementation Method:

You can set the platform title and custom directory names, template names, and the mobile server name as keys, and their corresponding Japanese as values.

After one-click platform language switchover, the language of the System Management page and custom keys will also be switched.

Preparation

Directory and Template Addition

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

Platform Title Modification

Choose System Management > Appearance Configuration > Platform Style and set Platform Title to 意思決定プラットフォーム.

Mobile Platform Server Name Modification

Choose System Management > Mobile Platform > App Config and set Server Name to いどうたんし, as shown in the following figure.

Browser Cache Disabling

Note:

If you do not enable Disable Browser Cache, you cannot switch the language of the management system.

Choose System Management > Security Management > Security and enable Security Headers. Click Advanced Setting and enable Disable Browser Cache.

Key-Value Addition

Choose System Management > Language Configuration, click Add, and enter keys and their Japanese translation respectively in the text box of Key and Japanese, 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 Japanese translation.

Note:

After the 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 Japanese, as shown in the following figure.

Effect Display

The language of both the System Management page and the platform title is switched to Japanese.

After clicking Directory, you can view the names of the directories and templates (added in section "Directory and Template Addition") displayed in Japanese, as shown in the following figure.

You can log in to the decision-making platform through the Data Analyst app to view the effect, as shown in the following figure.

The server name is displayed as いどうたんし.

The names of the directories and templates (added in section "Directory and Template Addition") are displayed in Japanese.

Language Configuration

Key-Value Management

Log in to the decision-making platform as the admin and choose System Management > Language Configuration to go to the internationalization setting page.

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.

Built-in Key Importing

The function Import Built-in Key allows you to obtain all the keys (built in the system) in batches. You can directly perform translations according to the keys or export the keys to an Excel file for translation and then import them back into the system.

Key-Value Importing in Batches

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 on the decision-making platform and select the data source, as shown in the following figure.

Note:

The Multilingual Configuration 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 Exporting in Batches

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 Back up. A backup success prompt pops up, indicating that the current keys and values have been backed up.

Click Restore. A backup restoration success prompt pops up, indicating that the backup has been restored, as shown in the following figure.

System Language Preference

Log in to the decision-making platform as the admin, and choose System Management > Language Configuration > More Configurations 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.

Platform-Supported Language: You can select languages supported by the system.

Note:

The system supports Simplified Chinese, Traditional Chinese, English, Japanese, and Korean.

Login Page Internationalization Setting

At the bottom of the decision-making platform login page, you can select the language for the login page. (The preset language is consistent with the language of the current browser.)

Note:

1. To use the language switchover function on the login page, the platform language preference must be set to 简体中文. For details, see section "System Language Preference."

2. For the FineBI system, if you want to use the language switchover function on the login page, you need to select Small Window in System Management > Appearance Configuration > Login Page > Login Style.