Working with ADF Desktop Integration Table-Type Components 7-33
Figure 7–14 Row Limit Exceeded Warning Message
7.18 Clearing the Values of Cached Attributes in an ADF Table Component
The RowData group of properties described in Table A–9
allow you to specify data to cache in the ADF Table component. For more information about this functionality, see
the following:
■
Section 12.7, Handling Data Conflicts When Uploading Data from a Workbook
■
Chapter 15, Using an Integrated Excel Workbook Across Multiple Web Sessions and in Disconnected Mode
The ADF Table component exposes an action ClearCachedRowAttributes that, when invoked, clears the values of cached attributes for the current row of the ADF
Table component.
Do not configure a component for example, an ADF Table component’s column or an ADF Input Text component so that an end user can view or edit an attribute binding
that you have also specified for an element in the RowData.CachedAttributes array. The RowData.CachedAttributes array caches the values retrieved by the
worksheet DownSync action. The worksheet UpSync action sends the values of the RowData.CachedAttributes array to the Fusion web application. This may
override edits an end user makes to an attribute binding exposed through a component in the worksheet.
7.18.1 How to Clear the Values of Cached Attributes in an ADF Table Component
Configure a DoubleClickActionSet that includes an action to invoke the ADF Table component’s ClearCachedRowAttributes action.
To clear the values of cached attributes in an ADF Table component: 1.
Open the integrated Excel workbook.
2.
Open the Action Collection Editor for the Oracle ADF component that is going to invoke the DoubleClickActionSet at runtime.
For more information about invoking action sets, see Chapter 8.2, Using Action
Sets.
3.
Add an action to the DoubleClickActionSet that invokes the ADF Table component’s ClearCachedRowAttributes action.
4. Click OK.
7.18.2 What Happens at Runtime When the ADF Table Component Clears Cached Values
The action set invokes the ADF Table component’s ClearCachedRowAttributes action. This action clears the cached values specified by the
7-34 Desktop Integration Developers Guide for Oracle Application Development Framework
RowData.CachedAttributes property for the current row of the ADF Table component.
7.19 Tracking Changes in an ADF Table Component
End users can create or modify data in the cells of an integrated Excel workbook that hosts an ADF Table component.
If a column is updatable and not read-only, change tracking is activated. End users can make the following changes to activate change tracking:
■
Edit cell values
■
Insert or delete cell values
■
Paste values to cells in the ADF Table component column that they copied elsewhere
A character that resembles an upward pointing arrow appears in a row of the _ADF_ ChangedColumn column if the end user makes a change to data in a corresponding
row. Figure 7–15
shows an example.
Figure 7–15 Changed Column in an ADF Table Component
This character appears if the end user makes a change to data hosted by a component where the component’s ReadOnly property value is False. The ADF Input Text and
TreeNodeList subcomponents both have a ReadOnly property. You can write an EL expression or a static string for this ReadOnly property that evaluates to True or
False. If you write a static string or an EL expression that evaluates to True, no character appears in the _ADF_ChangedColumn column. For more information about
ReadOnly EL expressions and change tracking, see
Section 7.8.2, What Happens at Runtime When an ADF Table Component Uploads Data.
If you write an EL expression for this ReadOnly property that evaluates to True, ADF Desktop Integration evaluates it differently to other EL expressions during change
tracking. This is because it is not desirable to invoke a connection to the Fusion web application if the end user makes changes to data in an ADF Table component while
working in disconnected mode. Instead, ADF Desktop Integration substitutes an empty string value for any part of an EL expression that requires a connection to the
Fusion web application. This behavior also applies to the ADF Table component column’s CellStyleName property.
For example, the end user in disconnected mode makes a change to a data value hosted by the ADF Input Text component in an ADF Table component column.
During change tracking, ADF Desktop Integration substitutes an empty string value in the parts of the EL expression for the ADF Input Text component’s ReadOnly
property and the ADF Table component column’s CellStyleName property that require a connection to the Fusion web application. For this reason, write EL
Note: During change tracking, cell styles are applied when the end
user inserts new worksheet rows.
