Languages and Localization: Difference between revisions

From QPR ProcessAnalyzer Wiki
Jump to navigation Jump to search
Line 37: Line 37:


== Content Language ==
== Content Language ==
Translations for process mining data (e.g. case and event attribute names, event type names, case and event attribute values) can be provided via the ContentTranslations value in the [[PA_Configuration_database_table#Localization_Settings|configuration table]]. When a valid ContentTranslations value is provided, the translations can be taken into use by selecting the "Content language" in the [[User_Profile|User Profile dialog]].
In addition to the user-interface, also user-defined content can be translated, i.e., eventlog data and dashboards. Translations for process mining data (e.g. case and event attribute names, event type names, case and event attribute values) are provided via the ContentTranslations setting in the [[PA_Configuration_database_table#Localization_Settings|configuration table]]. The content translation language can be selected in the [[User_Profile|User Profile dialog]] (available only when the content translataion have been defined). Only the dashboards are translated, so the user-defined content in Workspace appears with the original texts.


Some things to note:
Note that the search dialog searches are made based on the original texts, not the translated values.
* Search dialogs work only with the original text, not the translated values.
* The Workspace user interface isn't translated from the content viewpoint, except for datatable content preview, which is translated.


== Language Support Details ==
== Language Support Details ==

Revision as of 00:43, 21 June 2026

User Interface Languages

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

  • English
  • French
  • Spanish
  • German
  • Finnish
  • Swedish
  • Polish
  • Portuguese
  • Ukrainian

Changing User Interface 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).

User Date Format Preferences

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
    • 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.

In case the administrator needs to change these prefernces (e.g., for many users), the change needs to be done directly to the PA_USER_ATTRIBUTE table in the database.

Content Language

In addition to the user-interface, also user-defined content can be translated, i.e., eventlog data and dashboards. Translations for process mining data (e.g. case and event attribute names, event type names, case and event attribute values) are provided via the ContentTranslations setting in the configuration table. The content translation language can be selected in the User Profile dialog (available only when the content translataion have been defined). Only the dashboards are translated, so the user-defined content in Workspace appears with the original texts.

Note that the search dialog searches are made based on the original texts, not the translated values.

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) needs to be separately translated. See Content Language section below.
  • 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.

Default Localization Settings

The system-wide defaults for the localization settings can be set in the configuration table:

  • DefaultUiLanguage
  • DefaultDateFormat
  • DefaultFirstDayOfWeek
  • DefaultUse12HourClock

The defaults are applied for the new users, and users who haven't yet changed their personal location preferences.