9-8 Desktop Integration Developers Guide for Oracle Application Development Framework
■
An ADF Table component invokes its Download or DownloadForInsert actions
■
Rows are inserted into an ADF Table component
■
A worksheet invokes its DownSync action EL expressions that evaluate to styles are not applied when:
■
An ADF Table component invokes its RowDownSync action
■
The end user edits the format properties of a cell Note also that an EL expression that evaluates to a style is not reevaluated when
the end user edits a cell’s value.
■
The runtime value of an EL expression does not match a style defined in the end user’s integrated Excel workbook
In this scenario the style formats of the targeted cells do not change. Instead, they retain their existing style formats. If you configured client-side logging, ADF
Desktop Integration generates an entry in the log file when an EL expression evaluates to a style that is not defined in the end user’s integrated Excel
workbook. For more information about client-side logging, see
Section C.3, Generating Log Files for an Integrated Excel Workbook.
9.4 Using Labels in an Integrated Excel Workbook
Use labels to provide end users with information about how they use the functionality in an integrated Excel workbook. You can write EL expressions that retrieve the value
of string keys defined in a resource bundle or that retrieve the values of attribute control hints. An integrated Excel workbook evaluates the value of a Label property
only when the workbook is initialized.
Retrieving the Values of String Keys from a Resource Bundle
Figure 9–6 shows a portion of the design time view of the EditPriceList-DT.xlsx
workbook in the Master Price List module. It shows examples of ADF Label components and ADF Button components that have EL expressions specified for their
Label properties.
Figure 9–6 Design Time View of an ADF Label Component and an ADF Button
Component with Label Property
At runtime, these EL expressions resolve to string keys defined in the res resource bundle that is registered with the Master Price List module. You define resource
bundles in the workbook properties dialog. For information about referencing string keys from a resource bundle, see
Section 10.2, Using Resource Bundles in an Integrated Excel Workbook.
Figure 9–7 shows the corresponding runtime view of the ADF Label component and
ADF Button component illustrated in design mode in Figure 9–6
.
Configuring the Appearance of an Integrated Excel Workbook 9-9
Figure 9–7 Runtime View of an ADF Label Component and an ADF Button Component
with Label Property
Retrieving the Values of Attribute Control Hints In addition to string keys from resource bundles, the ADF Label component and the
Label property of other ADF components can reference attribute control hints that you define for entity objects and view objects in your JDeveloper project.
Figure 9–8 shows the expression builder for the Product Name column in the
EditPriceList-DT.xlsx workbook’s ADF Table component. The expression builder contains an EL expression for the HeaderLabel property of the
ProductName column that retrieves the value Product Name defined for an attribute control hint at runtime.
Figure 9–8 EL Expression That Retrieves the Value of an Attribute Control Hint for a
Label Property
Attribute control hints can be configured for both view objects and entity objects. Information about how to add an attribute control hint to an entity object can be found
in the Defining Attribute Control Hints for Entity Objects section of the Oracle Fusion Middleware Fusion Developers Guide for Oracle Application Development Framework.
Information about how to add an attribute control hint to a view object can be found in the Defining Attribute Control Hints for View Objects section of the Oracle Fusion
Middleware Fusion Developers Guide for Oracle Application Development Framework.
How an Integrated Excel Workbook Evaluates a Label Property An integrated Excel workbook evaluates the Label properties of ADF components
when the workbook is initialized after you or the end user opens the workbook for the first time. The integrated Excel workbook saves the retrieved values for the Label
properties when the workbook itself is saved to a directory on the system.
9-10 Desktop Integration Developers Guide for Oracle Application Development Framework
The retrieved values for the Label properties do not get refreshed during invocation of actions such as the worksheet’s DownSync action or the ADF Table component’s
Download action. You indirectly refresh the retrieved values of the Label properties if you invoke the workbook actions ClearAllData or EditOptions described in
Table A–17 .
9.5 Using Styles to Improve the User Experience
