/
Configuring Portal

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:

  1. Configure the repository database to support the UTF-8 character set (e.g., use locale-specific collation in MS SQL).

  2. 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:

  1. Create a language bundle file containing key-value pairs for text strings on the portal.

  2. 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.