To get multiple language support in Intellicus you need to make sure Intellicus portal and Intellicus server runs in UTF-8 mode. This mode ensures the programs are able to load, process and display multi-byte language characters.
Configuring Locales appearing on Intellicus Portal
The list of Locales, which users can select a locale from, is controlled by DEFAULT_LOCALE options tag in the XML configuration file: “ReportServerProperties.xml”. This file is placed at the path:
<Intellicus installation path>/Intellicus/ReportEngine/Config
For example, when you want to add “Chinese (Simplified)” as a new locale, then under the XML tag <OPTIONS NAME=”DEFAULT_LOCALE”> in the above-mentioned file enter the OPTION tag with OPTION entry.
<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>
<OPTION DISPLAY_TEXT=”Chinese (Traditional)”>
<VALUE><![CDATA[zh_TW]]></VALUE>
</OPTION>
</OPTIONS>
Note: You need to restart the Portal and Server after making any configuration changes.
If you want to remove any existing locale then you can remove the respective OPTION tag for that locale in the same file.
By default, English (US) is the available language. The list of languages supported in Intellicus that are license-controlled is given below:
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 Intellicus Portal in UTF-8 mode
An important prerequisite for Intellicus portal web server to serve language data is that it needs to run in UTF-8 mode.
Intellicus Portal’s running-mode is specified in run.bat startup file. This file is placed at path:
<Intellicus installation path>/Intellicus/Jakarta/bin
If the file has following entry, it means Intellicus Portal is running in UTF-8 mode.
set FILE_ENCODING=-Dfile.encoding=utf-8
This FILE_ENCODING variable is appended to the java launching parameters.
Note: If you don’t want Intellicus Portal to run in UTF-8 mode, comment out the above entry in the run.bat with REM.
Running Intellicus Report Server in UTF-8 mode
To support multi-byte language characters, Intellicus Report Server also needs to run in UTF-8 mode.
Intellicus Report Server’s running-mode is specified in run.bat file. This file is placed at path:
<Intellicus installation path>/Intellicus/ReportEngine/bin
If the file has following entry, it means Intellicus Report Server is running in UTF-8 mode.
set FILE_ENCODING=-Dfile.encoding=utf-8
This FILE_ENCODING variable is appended to the java launching parameters.
Note: If you don’t want Intellicus Report Server to run in UTF-8 mode, prefix the above entry in the run.bat with REM.
Important: Intellicus metadata is stored in database (known as repository database). To get multiple language support for Intellicus, make sure repository database is configured to support UTF-8-character set (example: locale-specific collation in MS SQL). Also make sure ‘Charset Encoding’ is set to UTF-8 under Navigate > Administration > Configure > Databases.
Important: Make sure, fonts that support Unicode fonts, like Arial Unicode MS are installed on machine where Intellicus server is running and the portal is being browsed.
Pre-configured items on Portal
Intellicus portal is pre-configured to accept following items in any language:
Folder name (Category name)
Report name
Report title
Report description
Published Report name
Published Report description
Query name
In a query, Caption name for selected field
OLAP Report name, Cube Object name
Quick Schedule name
Job name (Schedule Job page)
Dashboard name
Dashboard Widget name
Organization/User/Role name, Organization/User/Role description
Notification name
After a respective item is entered and saved in a selected language, it will appear in that language across portal pages without any configuration needs.
Field Caption name if specified in a local language will appear in local language on Ad hoc reports.
Note: When you import a Query Object from within Intellicus Desktop Studio, you receive only SQL part of the Query Object. So, Field captions specified in a local language are not available for use on Standard Reports.
Important: These items will appear in the language they were entered and saved regardless of the language you select.
Figure 10: Portal in Chinese language
Portal can be localized to make all the portal-text appear in the selected language. To do this, you need to:
Create language bundle file having key-value pair for all possible values that appear on portal.
Note: You need to restart the portal after making configuration related changes. Changed configuration will be effective only after server-restart.