Internationalizing Your Integrated Excel Workbook 10-5
3. Set _ADFDIres as the value of the Alias property when you register the resource
bundle you created in Step 1. For information about how to register a resource bundle, see
Section 10.2.1, How to Register a Resource Bundle in an Integrated Excel Workbook.
Table F–1 describes the string keys in the overridable resources that ADF Desktop
Integration supports. Supply an alternative value to the value listed in the English value column for each string key in the overridable resource.
10.2.4 What Happens at Runtime When You Override Resources That Are Not Configurable
ADF Desktop Integration retrieves the values of string keys listed in Table F–1
that you defined in the resource bundle you created. It retrieves the values of other string keys
that you did not define in the resource bundle you created from the reserved resource bundle.
10.2.5 What You May Need to Know About Resource Bundles
See the following sections for additional information about resource bundles in an integrated Excel workbook.
Resource Bundle Types ADF Desktop Integration supports use of the following types of resource bundle:
■
Properties bundle .properties
■
List resource bundle .rts
■
Xliff resource bundle .xlf For more information about resource bundles, see the Manually Defining Locales and
Resource Bundles section in the Oracle Fusion Middleware Web User Interface Developers Guide for Oracle Application Development Framework.
Caching of Resource Bundles in an Integrated Excel Workbook ADF Desktop Integration caches the values of string keys from the resource bundles
that an integrated Excel workbook retrieves when it first connects to the Fusion web application. If you change a string key value in a resource bundle after an integrated
Excel workbook has cached the previous value, the modified value does not appear in the workbook unless the ClearAllData workbook action is invoked and the end
user closes and reopens the workbook so that it retrieves the modified value from the Fusion web application. For more information about the ClearAllData workbook
action, see
Table A–17 .
EL Expression Syntax for Resource Bundles ADF Desktop Integration requires that you enclose the string key name in EL
expressions using the [] characters, as in the following example:
Note: If you provide override values for LOGIN_WINDOW_TITLE or
LOGIN_CONFIRM_CONNECT_2, the override values will not appear on the first connection to the web application. The default values will be
used on the first connection. For more information, see Section 10.2.2,
How to Replace String Key Values from the Reserved Resource Bundle.
10-6 Desktop Integration Developers Guide for Oracle Application Development Framework
{res[StringKey]} Note that ADF Desktop Integration does not support the following syntax:
{res.StringKey}
10.3 Localization in ADF Desktop Integration
ADF Desktop Integration integrates several diverse sets of technologies. Each of these technologies provides various options for controlling the choice of natural human
language when you localize your Fusion web application.
When the end user interacts with an integrated Excel workbook, various elements are involved. Each of these elements has its own set of supported languages and resource
translations. In such a scenario, the translation of language is the responsibility of the respective publisher.
Table 10–1 presents a summary of elements involved and their role in translation:
Figure 10–3 illustrates how various elements involved in a Fusion web application
play their role in translation.
Table 10–1 Summary of Localization
Area subject to localization
Determination of language to use
Microsoft operating system Operating system language settings. You can choose the
language through Regional Settings on Control Panel. Microsoft Office
Microsoft Office language settings Web pages displayed in
ADF Desktop Integration Dialog actions
Usually controlled by Microsoft Internet Explorer’s Language Preferences.
ADF Desktop Integration client resources
Microsoft Office language settings ADF Desktop Integration
server resources Microsoft Internet Explorer language preferences
ADF Desktop Integration custom resource bundles
Microsoft Internet Explorer language preferences
