Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
docs:2500_config_apps:1800_locales [2022/09/01 01:08] – [Creating Applications in Different Languages] administratordocs:2500_config_apps:1800_locales [2025/06/12 02:34] (current) – Rename to AwareIM aware_support3
Line 2: Line 2:
 ====== Creating Applications in Different Languages ====== ====== Creating Applications in Different Languages ======
  
-//**Aware IM**// supports applications in different languages – you can configure your application to be in any language you like. Not only that, but you can also change the language dynamically or choose different languages for different users. By default //**Aware IM**// uses English. To define a different language you need to configure a //locale//.+//**AwareIM**// supports applications in different languages – you can configure your application to be in any language you like. Not only that, but you can also change the language dynamically or choose different languages for different users. By default //**AwareIM**// uses English. To define a different language you need to configure a //locale//.
  
-This is how //**Aware IM**// works with different locales:+This is how //**AwareIM**// works with different locales:
  
   - If you do not define your own locale an implicit "system" locale will be used. This locale will use strings defined in your configuration (attribute labels, description etc) as is. You can define your configuration strings in any language as long as your keyboard allows you to type them in. However, there are also "system" strings – the strings that are used in the application but not defined in the configuration (standard error messages, standard prompts etc). These strings will be in English.   - If you do not define your own locale an implicit "system" locale will be used. This locale will use strings defined in your configuration (attribute labels, description etc) as is. You can define your configuration strings in any language as long as your keyboard allows you to type them in. However, there are also "system" strings – the strings that are used in the application but not defined in the configuration (standard error messages, standard prompts etc). These strings will be in English.
-  - When you define your own locale you can provide translation to //all// strings in the application – both system strings and configuration strings. //**Aware IM**// 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 [[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:
-<code aim> IF RegularUser.Country = 'Germany' THEN +<code aim>IF RegularUser.Country = 'Germany' THEN 
-   RegularUser.Locale = 'German'</code>+   RegularUser.Locale = 'German' </code>
  
- //**Aware IM**// will automatically use the locale with the name "German" when a user from Germany logs into the system.+ //**AwareIM**// will automatically use the locale with the name "German" when a user from Germany logs into the system.
  
  
Line 20: Line 20:
 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 //**Aware IM**// 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 [[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.
  
 You can also click on the following buttons: You can also click on the following buttons:
Line 34: Line 34:
 ==== Refresh ==== ==== Refresh ====
  
-If the configuration has been changed since you defined the locale you can refresh the strings – //**Aware IM**// will re-extract all configuration strings defined in the application and add the new ones to the table, so that you can provide translation to the newly added strings or delete those that are no longer used.+If the configuration has been changed since you defined the locale you can refresh the strings – //**AwareIM**// will re-extract all configuration strings defined in the application and add the new ones to the table, so that you can provide translation to the newly added strings or delete those that are no longer used.
  
 ==== Delete ==== ==== Delete ====
  • Last modified: 2022/09/13 18:06