Changing the Session Language Programmatically

You can change user language preferences programmatically for the remainder of a PeopleSoft Pure Internet Architecture session. This feature is useful if you are building a front end to your PeopleSoft system that does not involve the sign-in screen, and if you want to enable users to change their language preference at any time.

For example, an internet store application might enable anonymous sign-in by customers of the store to browse a catalog, and therefore would not display the sign-in screen. The PeopleCode SetLanguage built-in function could be linked to a PeopleCode program behind a button on a page to enable users to change the language of the interface after they have already been signed in as guest users.

The SetLanguage function temporarily overrides the user's default language preference and the %Language system variable, which evaluates to the language for the current preferred language.

Calling the SetLanguage function is the same as changing the Language Preference field on the International Preferences page.

The %Language_Base system variable makes it simple to determine the current preferred language and build language-specific functionality in PeopleCode.

If multi-language entry is enabled, %Language_Data returns the current data language selected by the user. Use %Language_Data if your application must know the language any entered application data is stored as in the component's related language records.