What Happens at Runtime When You Limit the Number of Rows a Component Downloads

7-32 Desktop Integration Developers Guide for Oracle Application Development Framework

4. Click OK.

Figure 7–13 shows the Edit Component dialog in the EditPriceList-DT.xlsx workbook where the row limit of an ADF Table component is configured. Figure 7–13 Limiting Number of Rows of an ADF Table Component

7.17.2 What Happens at Runtime When You Limit the Number of Rows a Component Downloads

When invoked, the Table-type component’s Download action downloads the number of rows that you specified as the value for RowLimit.MaxRows from the Fusion web application. A message dialog similar to the one in Figure 7–14 appears if you specify an EL expression for RowLimit.MaxRows or do not modify its default value: {_ADFDIres[ROWLIMIT_WARNINGS_MESSAGE_1]} RowLimit.WarningMessa ge Write an EL expression for this property to generate a message for the end user if the number of rows available to download exceeds the number specified by RowLimit.MaxRows. The default value also generates a message: {_ADFDIres[ROWLIMIT_WARNINGS_MESSAGE_1]} If the value for this property is null, the Download action downloads the number of rows specified by RowLimit.MaxRows without displaying a message to the end user. Table 7–10 Cont. RowLimit Group of Properties Set this property to... This value... 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