Configuring Portal
To enable multi-language support in Kyvos Reporting, ensure that both the Kyvos Reporting portal and server run in UTF-8 mode. UTF-8 mode ensures the system can load, process, and display multi-byte language characters.
Configuring Locales on the Kyvos Portal
Locales that users can select are managed through the ReportServerProperties.xml located at
<Kyvos Reporting installation path>/kyvosreporting/ReportEngine/Config
Adding a Locale
To add a locale, update the DEFAULT_LOCALE
options tag in the file. For example, to add Chinese (Simplified), insert the following snippet under the <OPTIONS NAME="DEFAULT_LOCALE">
tag:
<OPTIONS NAME="DEFAULT_LOCALE" TYPE="2" VALIDATEFOR="0" DISPLAY_TEXT="DEFAULT LOCALE" REFRESH="0" IS_HIDDEN="false"> <OPTION DISPLAY_TEXT="Default"> <VALUE><![CDATA[]]></VALUE> </OPTION> <OPTION DISPLAY_TEXT="Chinese (Simplified)"> <VALUE><![CDATA[zh_CN]]></VALUE> </OPTION> </OPTIONS>
Removing a Locale
To remove a locale, delete the corresponding <OPTION>
tag for that locale.
Applying Changes
Restart the portal and server after making any changes for them to take effect.
Default Supported Languages
Kyvos supports the following languages (subject to licensing):
Chinese Simplified
Chinese Traditional
Czech
Danish
Dutch
German
Finnish
French
Hindi
Hungarian
Indonesian
Italian
Japanese
Malay
Norwegian
Polish
Portuguese
Romanian
Russian
Slovak
Spanish
Swedish
Swahili
Turkish
Vietnamese
Thai
Bulgarian
Croatian
Estonian
Greek
Korean
Irish
Serbian
Ukrainian
Running Kyvos in UTF-8 Mode
Kyvos Reporting Portal
To configure the portal to run in UTF-8 mode, verify the following entry in the run.bat file located at:
<Kyvos Reporting installation path>\kyvosreporting\Jakarta\bin
set FILE_ENCODING=-Dfile.encoding=utf-8
If the portal should not run in UTF-8 mode, prefix the line with
REM
.
Kyvos Reporting Report Server
Similarly, ensure the run.bat file for the report server has the same entry:
<Kyvos Reporting installation path>\kyvosreporting\ReportEngine\bin
Configuring the Repository Database for UTF-8
To enable multi-language support:
Configure the repository database to support the UTF-8 character set (e.g., use locale-specific collation in MS SQL).
Set the Charset Encoding to UTF-8:
Navigate to Administration > Configure > Databases.
Pre-Configured Localized Items on the Portal
The Kyvos portal supports entering and saving the following items in any language without additional configuration:
Folder Names (Category names)
Report Names, Titles, and Descriptions
Published Report Names and Descriptions
Query Names
OLAP Report Names, Cube Object Names
Dashboard and Widget Names
Notification Names
Field Captions in Local Languages
Field captions entered in a local language will appear as such in Ad hoc reports.
Localizing Portal Text
To localize all portal text:
Create a language bundle file containing key-value pairs for text strings on the portal.
Restart the portal after making configuration changes for them to take effect.
Note
Items saved in a specific language will continue to appear in that language, regardless of the language selected on the portal.
Restarting the portal and server is required after making changes to configuration files.
Related content
Copyright Kyvos, Inc. All rights reserved.