Error message translations are handled in a similar way to displayable string translations. Each Java class that can produce error messages determines the customer’s current locale and chooses the correct error message resource bundles accordingly.

Default Translations

Commerce Reference Store error messages for the default locale (English) are defined in a number of locations. For the English translations, Commerce Reference Store uses a layered resource bundle model, where some of the error messages come from the ATG platform and Oracle ATG Web Commerce, and then Commerce Reference Store layers on additional error messages in additional resource bundle files as necessary. For example, some gift list error messages are stored in the /atg/commerce/gifts/UserMessages.properties file in <ATG10dir>/DCS/lib/resources.jar while additional gift list messages are stored in the /atg/commerce/gifts/UserMessages.properties file in <ATG10dir>/CommerceReferenceStore/Store/EStore/lib/classes.jar. It is the aggregate of these two /atg/commerce/gifts/UserMessage.properties files that represents the total collection of gift list error messages.

Commerce Reference Store uses this resource bundle from the ATG platform. It is stored in <ATG10dir>/DPS/lib/resources.jar.

Commerce Reference Store uses these resource bundles from Oracle ATG Web Commerce. They are stored in <ATG10dir>/DCS/lib/resources.jar.

Commerce Reference Store layers these resource bundles on top of bundles that exist in Oracle ATG Web Commerce. They are stored in <ATG10dir>/CommerceReferenceStore/Store/EStore/lib/classes.jar:

Finally, Commerce Reference Store adds these new resource bundles to the <ATG10dir>/CommerceReferenceStore/Store/EStore/lib/classes.jar file:

Creating Error Message Resource Bundles for Other Languages

To create localized error messages, you must create a set of companion resource bundles for each language. These files must:

Commerce Reference Store includes error message bundles for both German and Spanish. The German error messages are contained in the following files in <ATG10dir>/CommerceReferenceStore/Store/EStore/lib/classes.jar:

The Spanish error messages are contained in a similar set of files that use the _es extension in place of _de.

You can make copies of the error message resource bundles and edit them to include your localized text. Because they contain the aggregate of all English error messages, it is easiest to copy either the German or Spanish resource bundle files when creating resource bundles for a new language in Commerce Reference Store.