| Both sides previous revision Previous revision | |
| 2500_config_apps:1800_locales [2026/08/13 00:55] – ↷ Page moved from docs:2500_config_apps:1800_locales to 2500_config_apps:1800_locales localdev | 2500_config_apps:1800_locales [2026/08/13 00:55] (current) – ↷ Links adapted because of a move operation localdev |
|---|
| - When you define your own locale you can provide translation to //all// strings in the application – both system strings and configuration strings. //**AwareIM**// will automatically collect all strings used in the configuration and add predefined system strings, so that you can translate them all. | - When you define your own locale you can provide translation to //all// strings in the application – both system strings and configuration strings. //**AwareIM**// will automatically collect all strings used in the configuration and add predefined system strings, so that you can translate them all. |
| - You can configure multiple locales – one for each language. You can also designate that a particular locale should be used "by default" – that is, the application will always start in this locale and all users will be assigned this locale by default. If you just need to run the application in one non-English language, this is all you need to do – define a non-English locale (or maybe a variation of the English locale) and mark it as the default locale. | - You can configure multiple locales – one for each language. You can also designate that a particular locale should be used "by default" – that is, the application will always start in this locale and all users will be assigned this locale by default. If you just need to run the application in one non-English language, this is all you need to do – define a non-English locale (or maybe a variation of the English locale) and mark it as the default locale. |
| - If you configure multiple locales the user will be able to switch between locales at run-time if you include the [[docs:2500_config_apps:1500_add_edit_vp:0100_working_with_vp_editor:0500_defining_layout_of_content_panels:1100_setting_menu_item_props|"Locale Editing" menu command]] in your menu. You will also be able to assign different locales to different users by rules. Any member of the SystemUser business object group includes the Locale attribute that you can use in rules, for example: | - If you configure multiple locales the user will be able to switch between locales at run-time if you include the [[2500_config_apps:1500_add_edit_vp:0100_working_with_vp_editor:0500_defining_layout_of_content_panels:1100_setting_menu_item_props|"Locale Editing" menu command]] in your menu. You will also be able to assign different locales to different users by rules. Any member of the SystemUser business object group includes the Locale attribute that you can use in rules, for example: |
| <code aim>IF RegularUser.Country = 'Germany' THEN | <code aim>IF RegularUser.Country = 'Germany' THEN |
| RegularUser.Locale = 'German' </code> | RegularUser.Locale = 'German' </code> |
| The following section describes how to work with the editor of locales when adding a new locale or editing the existing one. | The following section describes how to work with the editor of locales when adding a new locale or editing the existing one. |
| |
| The editor of locales can be started as described in the [[docs:2500_config_apps:0300_work_config_elements|Working with Configuration Elements]] section. The working area of the locale editor contains a table of stings used in the application. When a locale is created for the first time //**AwareIM**// automatically extracts all strings used in the configuration and adds to them the system strings. You can provide translation to both configuration and system strings by clicking on the "Translation" column in the table. Initially the translation is set to "use the original string", which means that if you do not provide a translation the original string will be used. Strings that have not been translated are displayed in pink. Translated system strings are displayed in green and translated configuration strings are displayed in white. | The editor of locales can be started as described in the [[2500_config_apps:0300_work_config_elements|Working with Configuration Elements]] section. The working area of the locale editor contains a table of stings used in the application. When a locale is created for the first time //**AwareIM**// automatically extracts all strings used in the configuration and adds to them the system strings. You can provide translation to both configuration and system strings by clicking on the "Translation" column in the table. Initially the translation is set to "use the original string", which means that if you do not provide a translation the original string will be used. Strings that have not been translated are displayed in pink. Translated system strings are displayed in green and translated configuration strings are displayed in white. |
| |
| You can also click on the following buttons: | You can also click on the following buttons: |
| ==== Default ==== | ==== Default ==== |
| |
| Tick this box if you want the locale to be used in the application by default – the application will start in this locale and all users will be assigned this locale unless changed by rules (see the [[docs:2500_config_apps:1800_locales|Creating Applications in Different Languages]] section). | Tick this box if you want the locale to be used in the application by default – the application will start in this locale and all users will be assigned this locale unless changed by rules (see the [[2500_config_apps:1800_locales|Creating Applications in Different Languages]] section). |
| |
| ==== Date format ==== | ==== Date format ==== |
| |
| Select the date format of the locale. This format will be used for those attributes of the "Date" type that have "Take from locale" value set as their format (see [[docs:2500_config_apps:0700_add_edit_attributes:0400_date_time_attrib|Adding/Editing Date Attributes]]) | Select the date format of the locale. This format will be used for those attributes of the "Date" type that have "Take from locale" value set as their format (see [[2500_config_apps:0700_add_edit_attributes:0400_date_time_attrib|Adding/Editing Date Attributes]]) |
| |
| ==== Timestamp format ==== | ==== Timestamp format ==== |
| |
| Select the timestamp format of the locale. This format will be used for those attributes of the "Timestamp" type that have "Take from locale" value set as their format (see [[docs:2500_config_apps:0700_add_edit_attributes:0400_date_time_attrib|Adding/Editing Date Attributes]]) | Select the timestamp format of the locale. This format will be used for those attributes of the "Timestamp" type that have "Take from locale" value set as their format (see [[2500_config_apps:0700_add_edit_attributes:0400_date_time_attrib|Adding/Editing Date Attributes]]) |
| |
| ==== Language of system messages ==== | ==== Language of system messages ==== |