This section describes the use of the RequestLocale and OrginatingRequest.requestLocale components that is specific to the Personalization module. It contains the following topics:
Personalization RequestLocale Hierarchy
The Personalization module request locale hierarchy is set by default to the following. This hierarchy differs from the Oracle Commerce Platform request locale hierarchy in that the Personalization module hierarchy includes the profile attribute.
Profile
localeproperty: Thelocalevalue in the profile can be set, for example, by having the user choose a locale from a list of choices on a Preferences page that is provided at the web site.The
ACCEPT-LANGUAGE HTTPheader: This is set in the/atg/dynamo/component.
servlet/RequestLocale.validLocalesDefault request locale: This is defined in the
/atg/dynamo/component.
servlet/RequestLocale.defaultRequestLocaleNameThe default locale specified in the server’s JVM.
See also Allowing Users to Choose a Locale.
Personalization RequestLocale Properties
The Personalization module sub-classes the Oracle Commerce Platform RequestLocale object to obtain a locale from the visitor’s profile. The Personalization module adds the following properties to the RequestLocale component.
profilePath: The Nucleus path to the Profile object in each session. This is required so that theRequestLocalecomponent can access the visitor’s profile.profileAttributeName: This attribute specifies the locale choice of the visitor. It is best to let this value default to null in the profile template. If this value defaults to null and the user has not made a language choice, no locale is assigned from the profile. The other locale determinants such as the request’sACCEPT-LANGUAGE HTTPheader are used for the session until the user makes a language choice and thereby sets the profile attribute value.
