Intellicus Enterprise Reporting and Business Insights 19.0

Configuring Intellicus Portal

0 views June 28, 2020 0

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>IntellicusReportEngineConfig

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>IntellicusJakartabin

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>IntellicusReportEnginebin

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.

Portal in Chinese
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.