Languages and Localization: Difference between revisions

Latest revision as of 07:33, 17 May 2023

Each users can set their desired language for the user interface. QPR ProcessAnalyzer has the following languages available:

English
French
Spanish
German
Finnish
Swedish
Polish
Portuguese

Changing Language

User interface language can be changed in the User Settings dialog as follows:

Login to QPR ProcessAnalyzer.
Open the navigation menu on top left and click User Settings.
Choose the desired language in the Language list.
Click Save to close the dialog.

The selected language is stored to user settings, so that it is in use when the user logs in the next time (also when using another device).

Date Format Settings

In addition to the language, the following date presentation related settings can be set for each user in the User Settings dialog:

Date format: Defines how date values are presented in the user interface. The format can be e.g. MM/dd/yyyy or d.M.yyyy. Following parts can be used in the date format: d (day of month as one or two digits), dd (day of month as two digits), M (month as one or two digits), MM (month as two digits), yy (year as two digits) and yyyy (year as four digits).
First day of week: The first day of the week (appearsing in calendars to pick dates).
Use 12-hour clock: Whether the 24-hour or 12-hour clock is used to present hours.

Similar to the language, all these settings are remembered for the user.

Language Support Details

Most texts in the UI are translated, but there are the following exceptions:

Process mining data imported to QPR ProcessAnalyzer (e.g. case and event attribute names, event type names, case and event attribute values)
Some tooltips that contain longer instructions
Some special error messages related to the expression language errors

The login page is shown with the system default language, when QPR ProcessAnalyzer is for the first time accessed with a certain device. Language is also stored to the browser's local storage, so the browser remembers the last used language and in the next time shows the login page in that language.

Localization Settings for New Users

For system administrators, there are system wide defaults for the localization settings that can be set in the configuration table:

DefaultUiLanguage
DefaultDateFormat
DefaultFirstDayOfWeek
DefaultUse12HourClock

New users have these defaults until the user changes to her/his own settings. In case the administrator needs to change the language for many existing users, the change needs to be done directly to the PA_USER_ATTRIBUTE table in the database.

@@ Line 1: / Line 1: @@
-Users can set their own language for the user interface. Available languages are:
+Each users can set their desired language for the user interface. QPR ProcessAnalyzer has the following languages available:
 * English
 * French
-* Russian
 * Spanish
 * German
@@ Line 8: / Line 7: @@
 * Swedish
 * Polish
+* Portuguese
 == Changing Language ==
-User language can be changes as follows:
+User interface language can be changed in the [[Navigation_Menu#User%20Settings|User Settings dialog]] as follows:
 # [[Getting_Started_with_QPR_ProcessAnalyzer#Logging_in|Login to QPR ProcessAnalyzer]].
-# Click the ''Main menu'' (on top left) and click '''User Settings'''.
+# Open the navigation menu on top left and click '''User Settings'''.
-# Choose a language from the '''Language''' drop-down list.
+# Choose the desired language in the '''Language''' list.
 # Click '''Save''' to close the dialog.
-The language is remembered by the system when the user logs in the next time (also when using another computer).
+The selected language is stored to user settings, so that it is in use when the user logs in the next time (also when using another device).
 == Date Format Settings ==
-In addition to the language, the following date formatting related settings can be set by each user in the User Settings Dialog:
+In addition to the language, the following date presentation related settings can be set for each user in the [[Navigation_Menu#User%20Settings|User Settings dialog]]:
-* '''Date format''': Defines how date values appears in the Web UI. The format can be e.g. MM/dd/yyyy or m.D.yyyy. Following parts that can be used: '''d''' (day of month as one or two digits), '''dd''' (day of month as two digits), '''M''' (month as one or two digits), '''MM''' (month as two digits), '''yy''' (year as two digits) and '''yyyy''' (year as four digits).
+* '''Date format''': Defines how date values are presented in the user interface. The format can be e.g. MM/dd/yyyy or d.M.yyyy. Following parts can be used in the date format: '''d''' (day of month as one or two digits), '''dd''' (day of month as two digits), '''M''' (month as one or two digits), '''MM''' (month as two digits), '''yy''' (year as two digits) and '''yyyy''' (year as four digits).
-* '''First day of week''': The first day of the week that appears in calendars to pick dates.
+* '''First day of week''': The first day of the week (appearsing in calendars to pick dates).
-* '''Use 12-hour clock''': Whether the 24-hour or 12-hour clock is used.
+* '''Use 12-hour clock''': Whether the 24-hour or 12-hour clock is used to present hours.
-All these settings are remembered by the system, so they are always used for the user, until changed.
+Similar to the language, all these settings are remembered for the user.
 == Language Support Details ==
-Almost all items in the UI are translated with the following exceptions:
+Most texts in the UI are translated, but there are the following exceptions:
-* Actual process mining data imported to QPR ProcessAnalyzer (e.g. case and event attribute names, event type names, case and event attribute values)
+* Process mining data imported to QPR ProcessAnalyzer (e.g. case and event attribute names, event type names, case and event attribute values)
-* Some tooltips that contain detailed instructions
+* Some tooltips that contain longer instructions
-* Some special error messages
+* Some special error messages related to the expression language errors
-In addition, date and number formats are set based on corresponding cultural conventions. English uses the US conventions.
+The login page is shown with the system default language, when QPR ProcessAnalyzer is for the first time accessed with a certain device. Language is also stored to the browser's local storage, so the browser remembers the last used language and in the next time shows the login page in that language.
-There is a [[#Changing_System_Default_Language|system wide default language]] which new user accounts get until user changes her/his language. Also the login page is translated using the default language, when QPR ProcessAnalyzer is for the first time accessed using a certain web browser. The language is stored to that browser's local storage, and thus the browser remembers the last used language and in the next time shows the login page in that language.
+== Localization Settings for New Users ==
+For system administrators, there are system wide defaults for the localization settings that can be set in the [[PA_Configuration_database_table|configuration table]]:
+* DefaultUiLanguage
+* DefaultDateFormat
+* DefaultFirstDayOfWeek
+* DefaultUse12HourClock
-The language is also stored to the ''sys:language'' session variable. The variable cannot be removed and it must contain one of the valid languages.
+New users have these defaults until the user changes to her/his own settings. In case the administrator needs to change the language for many existing users, the change needs to be done directly to the ''PA_USER_ATTRIBUTE'' table in the database.
-The system default language is stored to the database configuration table to setting '''[[PA_Configuration_database_table_in_QPR_ProcessAnalyzer#:~:text=DefaultUiLanguage|DefaultUiLanguage]]'''.
+__NOTOC__
 [[Category: QPR ProcessAnalyzer]]