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
It is good practice to provide end users of integrated Excel workbooks with information that helps them understand how to use the ADF components that you
provide to integrate with a Fusion web application. You can do this by:
■
Providing end users with instructions on how to use Oracle ADF components such as ADF Button and ADF Input Text components.
The ADF Label component and the Label property of other ADF components is useful for this task, as you can write labels that instruct the end user on how to use
the component.
■
Apply styles that indicate if an ADF component is read-only or read-write.
Using ADF Label Components to improve the User Experience You can use ADF Label components to provide end users of an integrated Excel
workbook information about how to use other ADF components in the workbook. For example, many forms, by convention, use an to indicate to end users that they must
enter a value in an input field.
Figure 9–9 shows three ADF Input Text components
with ADF Label components in adjoining cells. Each ADF Label component references an EL expression that retrieves the value of a string key from a resource bundle at
runtime. Each string key includes the character to indicate to end users that they must supply a value.
Figure 9–9 ADF Label Components Providing End-User Instruction
For information about using resource bundles, see Section 10.2, Using Resource
Bundles in an Integrated Excel Workbook.
About the Read-Only Property in an Integrated Excel Workbook Note the following points about the read-only property in an integrated Excel
workbook:
■
ADF Output Text, ADF Label, and ADF Table header row do not have read-only properties. However, these components have implied read-only behavior. In
addition, end users can enter values in the cells that host these components and temporarily change the values that appear in these cells. ADF Desktop Integration
ignores these changes when uploading from the worksheet and overwrites them when it downloads data from the Fusion web application.
Configuring the Appearance of an Integrated Excel Workbook 9-11
■
The ADF Input Text component, ADF List of Values component, and TreeNodeList subcomponent each have a read-only property ReadOnly.
■
To protect the values of read-only cells at runtime, set the worksheet protection to automatic. When an attempt is made to edit a read-only cell after enabling
worksheet protection, Excel displays a warning message and the edit is blocked. For more information about worksheet protection, see
Section 9.7, Using Worksheet Protection.
■
Do not use the Excel’s Protect Sheet or Protect Workbook features directly in an integrated Excel workbook. Also, enure that end users do not also use these
features.
To prevent end-user confusion, apply styles to components, such as the ADF Output Text component, that indicate to end users whether a component is read-only or can
be edited. By default, the ADF Output Text component uses the predefined style, _ ADFDI_OutputTextStyle. You can define your own styles and apply them to
components as described in this chapter.
For more information about the properties that ADF Desktop Integration components support, see
Appendix A, ADF Desktop Integration Component Properties and Actions.
9.6 Branding Your Integrated Excel Workbook
