Localization is adapting a website into different linguistic and cultural contexts - involving much more than the simple text translation.
By default, the Bold BI application is available in English(en-US)
localization.
Refer to the following documentation to add a new localization and edit the existing localization:
NOTE: To apply localization files in Bold BI version 4.2.69 or earlier refer to this.
Create a folder inside the locale folder and mention the folder name in the locale language code in which you want to generate the localization file.
Please refer to this link for a sample language code. Here, create a folder called fr-FR
, which represents the French language code.
Create application folders with the following names inside the language code folder for each service:
To add messages.pot
in above created application folder refer to this.
To create locale file messages.po
from messages.pot
either using manual edit option or online tool for the BI
and UMS
services refer to this.
To create locale file messages.po
from default.po
either using manual edit option or online tool for the Designer
service refer to this.
NOTE:
By default, the Bold BI is deployed in C:\BoldServices
location for Windows and /var/www/bold-services/application
location for Linux.
BI Service
Copy the messages.pot
file present in the folder bi\web\locale\
and paste the file inside app_data\locale\[language-folder]\bi\
folder.
UMS Service
Copy the messages.pot
file present in the folder idp\web\locale\
and paste the file inside app_data\locale\[language-folder]\ums\
folder.
Designer Services
Copy the default.po
file present in the folder bi\dataservice\locale
and paste the file inside app_data\locale\[language-folder]\bi-dataservice\
folder.
Copy the locale.js
file present in the folder bi\dataservice\locale\en-us
and paste the file inside app_data\locale\[language-folder]\bi-dataservice\
folder.
You can generate the localization file for the application in two ways as follows:
NOTE:
• After generating the messages.po
file for bi-dataservice
you need to run the locale utility. Refer to this link to generate the locale js file.
• Restart the site to apply the generated language for the application.
BI
or UMS
Rename the above pasted messages.pot
file into messages.po
. Here, the localization file has been generated for the BI
service.
BI-DATASERVICE
Rename the above pasted default.po
file to messages.po
.
There are two variables in this file : msgid
and msgstr
.
msgid
- It contains the product content in the default language.
msgstr
- It is empty and represents the translated language.
Convert the content in the msgid
into the equivalent language of the desired localization support. Replace this converted content into the empty string in msgtr
.
Change the locale Language code in the top of the messages.po
file.
Here, the sample converted locale file will appear as follows:
BI
or UMS
messages.pot
file to messages.po
.BI-DATASERVICE
default.po
file to messages.po
.Use this online site https://www.matecat.com/ for generating the localization file.
Here, browse to select the messages.po
file in the application folder.
Change the language in the To
option, to the language that you want to generate the localization file.
Select the Analyze
option and then click Translate
.
Now, there is a download icon at the top of the page. Use it to download the file.
Change the downloaded file name to messages.po
and paste it into the respective application folder inside the app_data\locale\[language-folder]\
.
Download the locale Utility from this link provided. Once the download is completed, extract the .Zip
file.
Open the appsettings.json
file in an editor and modify the boldbi_custom_locale_path
as the deployed path of the application designer locale files and boldbi_locale_path
locale as the deployed path of default designer locale files.
Then, run the BoldBI.Locale.Utility.exe
file.
Once, you have run the utility, a locale.js
file will be generated in the newly created localized folder path of the designer locale app_data\locale\[language-folder]\bi-dataservice\
.
Open the appsettings.json
file in an editor from the location {Deployed Location}\bi\dataservice
and change the locale path as the app data location ../../app_data/locale
in the property locale-path.
After generating the localization file using the preceding steps, you can set the global language in the UMS application.
This language is applied to UMS, BI, and Designer Service
when there is no language is selected in site settings or user preference settings and the Application language should be set to Inherit from global settings
in site settings.
Change the localization on the site settings page. By default, the site language is selected with the English language. If you want to change language, you can change to the desired language after generating the localization file for the BI
and BI-DATASERVICE
services using the above steps.
Admins can enforce a language to all the users on the site. If the admin enforced a language, then the user preference settings is disabled.
By clicking the Update application language details through your account
link on the profile page, the user will be redirected to UMS profile page where they can set their own language preference.
A user can set any language as the preferred language and it will be applied on all the sites, but when the admin disables the user language preference on any site, then the user’s preferred language will not be applied on that site.