Internationalizing App-Generated Notifications

You can internationalize notifications generated by the apps.

For example, Collaboration and Approvals sends notifications to a person when an event occurs that the person has subscribed to, such as when a user adds a document to a Bookmark. All apps with a routing feature notify task assignees when their tasks are created. These system-generated emails can be sent in the language chosen by the user or they can be sent with the message text repeated in multiple languages.

This task shows you how to:

Specify Default Languages for System Notifications

You can specify the default languages the system uses for notifications.

  1. Create or open the text file to contain customized properties for emxSystem.properties. For more information, see Editing Properties Using MQL.
  2. If the user has not or cannot specify a Default Language (if this option was removed from the Preferences page), add or edit this line in the file used to import properties into a page object: 

    emxFramework.NotificationLanguages = en

    The language must have a corresponding emxFrameworkStringResource.properties file. By default, these languages are English (en), French (fr), German (de), Italian (it), and Japanese (ja).

    The message text of each system-generated notification is repeated in all of the languages you specify. The subject will be in the first language listed. Use the standard abbreviation for each language and separate languages by a space. For example, if you enter the value "en fr de", the subject of all system emails will be in English and each message will be repeated in English, French, and German.

    Only messages with translated text defined in the appropriate emxFrameworkStringResource.properties file can be internationalized; ad hoc messages created by users cannot be internationalized. When a user creates an ad hoc message, all recipients receive the message in the language used by the message creator.

  3. When finished updating the text file with all properties you want to modify, including the ones shown here, use the text file to modify the emxSystem.properties page object. For more information, see Editing Properties Using MQL.

Remove a Language from the User Preference List

You can remove a language from the user's preference list.

  1. Create or open the text file to contain customized properties for emxSystem.properties. For more information, see Editing Properties Using MQL.
  2. Add or edit this line in the file used to import properties into a page object:

    emxFramework.IconMailLanguagePreference=English German French Italian Japanese

  3. Delete the language you want to remove and the space following it from the IconMailLanguagePreference property.
  4. Add or edit the line for the local language in the file used to import properties into a page object. For example, if you want to remove Japanese, add this line:

    emxFramework.IconMailLanguageLocaleJapanese=ja

  5. Comment out the above property by adding a # to the beginning of the line. For example:

    #emxFramework.IconMailLanguageLocaleJapanese=ja

  6. When finished updating the text file with all properties you want to modify, including the ones shown here, use the text file to modify the emxSystem.properties page object. For more information, see Editing Properties Using MQL.

Add a Language to the User Preference List

You can add a language to the user's preference list.

  1. Create or open the text file to contain customized properties for emxSystem.properties. For more information, see Editing Properties Using MQL.
  2. Add or edit this line in the file used to import properties into a page object: 

    emxFramework.IconMailLanguagePreference=English German French Italian Japanese

  3. Add the new language to the value, separated from the other languages with a space.
  4. Add this line in the file used to import properties into a page object:

    emxFramework.IconMailLanguageLocale<LANGUAGE>=<2LETTERABBR>

    where <LANGUAGE> is the same language entered in step 3 and <2LETTERABBR> is the standard abbreviation for that language.

  5. When finished updating the text file with all properties you want to modify, including the ones shown here, use the text file to modify the emxSystem.properties page object. For more information, see Editing Properties Using MQL.
  6. Make sure the emxFrameworkStringResource.properties file for the language has a set of properties for the drop-down list text.