Languages and Localization: Difference between revisions

From QPR ProcessAnalyzer Wiki
Jump to navigation Jump to search
No edit summary
 
(36 intermediate revisions by the same user not shown)
Line 1: Line 1:
In QPR ProcessAnalyzer, each user can set their own language in which the user interface is shown. The available languages are English and French.
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


== Language Support ==
== Changing Language ==
Almost all texts in the web UI are translated with the following exceptions:
User interface language can be changed in the [[Navigation_Menu#User%20Settings|User Settings dialog]] as follows:
* Actual process mining data imported to QPR ProcessAnalyzer (e.g. case and event attribute names, event type names, case and event attribute values)
# [[Getting_Started_with_QPR_ProcessAnalyzer#Logging_in|Login to QPR ProcessAnalyzer]].
* Some tooltips that contain detailed instructions
# Open the navigation menu on top left and click '''User Settings'''.
* Some special error messages
# Choose the desired language in the '''Language''' list.
# Click '''Save''' to close the dialog.


In addition, there is a system wide default language which new user accounts get until user changes her/his language. In addition, the login page is translated using the default language, when QPR ProcessAnalyzer is for the first time accessed from a certain web browser.
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).


The language is stored to the browser local storage, and thus the web browser remembers the last used language and next time shows the login page using that language. 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.
== Date Format Settings ==
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 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.


== Changing User language ==
Similar to the language, all these settings are remembered for the user.
User language can be changes as follows:
# Login to QPR ProcessAnalyzer.
# Click the ''Main menu'' (on top left) and click '''User Settings'''.
# Choose a language from the '''Language''' list, and click '''Yes''' for the confirmation message.


The language is saved to user settings so the language is remembered when when the user logs in the next time.
== 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


== Changing System Default Language ==
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.
The system default language is stored to the [[PA_Configuration_database_table_in_QPR_ProcessAnalyzer#:~:text=DefaultUiLanguage|database configuration table]], so more information can be found from there.


== 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
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.
__NOTOC__
[[Category: QPR ProcessAnalyzer]]
[[Category: QPR ProcessAnalyzer]]

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:

  1. Login to QPR ProcessAnalyzer.
  2. Open the navigation menu on top left and click User Settings.
  3. Choose the desired language in the Language list.
  4. 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.