Example: Configuration File Settings for Specifying the Time Zone

15-4 System Administrators Guide for Oracle Business Intelligence Enterprise Edition

15.2.1.2 Localizing Messages for Users Preferred Currency

Section 16.2.1, Defining User-Preferred Currency Options Using a Static Mapping provides a procedure for working with users preferred currencies. Use the following procedure to localize the messages that are associated with a preferred currency. To localize the messages that are associated with each users preferred currency: 1. Go to the ORACLE_ INSTANCE\bifoundation\OracleBIPresentationServicesComponent\coreapplicati on_obipsn\msgdb\l_xx directory, where xx is the language extension for the language in which you are specifying preferred currencies.

2. In the directory, create a subdirectory called custommessages.

3. In the directory, create a file in XML format, with the name of

usercurrencymessages.xml.

4. Add entries such as the following one to this file for the language that corresponds

to the directory in which you are working. The following example includes two messages: kmsgMyCurrency1 and kmsgMyCurrency2 ?xml version=1.0 encoding=utf-8? WebMessageTables xmlns:sawm=com.siebel.analytics.webmessagev1 WebMessageTable system=CurrencyDisplay table=Messages code=false WebMessage name=kmsgMyCurrency1TEXTMy Currency Text 1TEXTWebMessage WebMessage name=kmsgMyCurrency2TEXTMy Currency Text 2TEXTWebMessage WebMessageTable WebMessageTables 5. Edit the userpref_currencies.xml file to specify displayMessage=kmsgMyCurrency1 to use this message. 6. Repeat Steps 1 through 5 for each language for which you must localize these messages. 7. Restart the service for Oracle BI Presentation Services. In Oracle BI EE, the appropriate localized text is displayed to the user. In this example, the text is My Currency Text 1.

15.2.1.3 Specifying the Default Language for the Sign-In Page

The default language in which the Presentation Services sign-in page is displayed is obtained from the users client browser settings. The following procedure explains how to change the language. To change the default language on a users login screen in Internet Explorer: 1. In Internet Explorer, from the Tools menu, select Internet Options. The Internet Options dialog is displayed.

2. Click Languages.

The Language Preference dialog is displayed. Note: The following procedure uses Internet Explorer 7.0 as an example. If you are using a different browser, then make the necessary substitutions. Localizing Oracle Business Intelligence 15-5 Installed languages are displayed in the Language list. The language at the top of the list is used as the default language. 3. If the desired language is not installed on the browser, then add it.

4. Use the Move Up and Move Down buttons to position the desired language at the

top of the list. 5. Restart the browser and sign into Presentation Services. The default language should match the language in the browsers Language list.

15.2.1.4 Configuring the Languages and Locales for the Sign-In Page

You can configure the languages and locales that are available to users on the sign-in page. This ability is helpful for limiting the number of languages and locales that users can access. You use the AllowedLanguages and AllowedLocales elements in the instanceconfig.xml file to specify the available languages and locales. To manually configure the languages and locales that are available: 1. Open the instanceconfig.xml file for editing, as described in Section 3.6, Where Are Configuration Files Located?

2. Locate the ServerInstance section, in which you must add the following elements:

■ AllowedLanguages — Specifies the languages that are available for selection, as a comma-delimited list. You can specify a list of the following identifiers, which are ISO 639 language codes: ar es da de el en es fi fr he hr hu it ja ko nl no pl pt pt-BR ro ru sk sv Note: If a user does not select a different language from the list on the sign-in page, then the setting for the User Interface Language in the users My Account dialog determines the language in which the user interface is displayed. 15-6 System Administrators Guide for Oracle Business Intelligence Enterprise Edition th tr zh-CN zh-TW ■ AllowedLocales — Specifies the locales that are available for selection, as a comma-delimited list. You can specify any definition from the localeDefinitions.xml file in the ORACLE_HOMEbifoundationwebdisplay directory. You specify the locales using ISO 639 language codes followed by ISO 3166 country codes. Examples include fr-fr and fr-ca. 3. Include the elements and their ancestor elements as appropriate, as shown in the following example: ServerInstance Localization AllowedLanguagesen,fr,pt-BRAllowedLanguages AllowedLocalesen-ca,en-usAllowedLocales Localization ServerInstance 4. Save your changes and close the file. 5. Restart Oracle Business Intelligence.

15.2.1.5 Specifying the Language in the URL

When users start Oracle BI EE by displaying the sign-in page, they can select the language as part of the sign-in process. They can also select a language on the Preferences tab of the My Account dialog. If you provide users with a URL with which they can display a dashboard or other page of the application, then you can define a URL parameter as a profile attribute. Doing so dynamically sets the language of the dashboards and analyses to be consistent with the applications language setting. For operational applications, symbolic URLs embed dashboards and analyses in the integrated environment. For Oracle BI Presentation Services, the URL parameter Lang designates the language that the Web page renders. The Lang parameter can be included in the symbolic URL that is defined in the operational application to connect to Oracle Business Intelligence. The Lang parameter is defined as a profile attribute, but when the symbolic URL is constructed at run time, the value is set as the profile attribute LanguageCode. Table 15–1 provides examples of the parameter settings in the Symbolic URL parameters applet, including Lang. For example, the following URL displays the sign-in page in French. http:Server_Name:port_numberanalyticssaw.dll?DashboardLang=fr Table 15–1 Example of Settings in the Symbolic URL Parameters Applet Name Type Path Argument Value Append Sequence Cmd Constant Go Y 1 Path Constant sharedSalesPipelineOvervi ewTop 10 Deals Y 2 nQUser Command UseLoginId Y 3 nQPassword Command UseLoginPassword Y 4