Working with ADF Desktop Integration Table-Type Components 7-19
2.
Select the cell in the Excel worksheet that references the ADF Table component, and then click the Edit Component button in the Oracle ADF tab.
3.
Set values for the BatchOptions group of properties in the property inspector that appears.
4. Click OK.
Note that a failure at the Entity level is not considered a batch failure. A failure at commit level for example, a wrong value for a foreign key attribute is considered as
batch failure.
7.10.2 Row Flagging in an ADF Table Component
By default, the ADF Table component includes a column, _ADF_FlagColumn, that facilitates the selection of rows for flagged-row processing. Double-clicking a cell of
the _ADF_FlagColumn column flags the corresponding row for processing by actions invoked by a component action.
When the end user double clicks a cell of the _ADF_FlagColumn column, a solid circle appears, or disappears, in the cell to indicate that the row is flagged, or not.
Figure 7–6 shows an example of a flagged column.
Figure 7–6 Flagged Column in an ADF Table Component
Table 7–8 RowData.BatchOptions Properties
Set this property... To...
BatchSize Specify how many rows to process before an ADF Table
component action Upload or DeleteFlaggedRows invokes the action binding specified by CommitBatchActionID. Any
value other than a positive integer results in all rows being processed in a single batch. The default value is 100 rows.
CommitBatchActionID The action binding to invoke after the ADF Table component
processes each batch. Typically, this is the Commit action binding.
LimitBatchSize True
When True, the ADF Table component processes rows in batches determined by the value of BatchSize. When False,
the ADF Table component uploads all modified rows in a single batch.
True is the default value. StartBatchActionID
Specify the action binding to invoke at the beginning of each batch.
Note:
By default, the solid circle character indicates a row flagged for flagged-row processing. However, any nonempty cell in a _ADF_
FlagColumn column flags the corresponding row for flagged-row processing.
7-20 Desktop Integration Developers Guide for Oracle Application Development Framework
The following component actions can be invoked on flagged rows:
■
DeleteFlaggedRows
■
DownloadFlaggedRows You can use the FlagAllRows component action to flag all rows, and the
UnflagAllRows component action to unflag all rows of the ADF Table component. Use of these component actions is dependent on the appearance of the _ADF_
FlagColumn column in the ADF Table component. If you remove the _ADF_ FlagColumn column from the ADF Table component, you cannot invoke any of these
component actions. For more information about these component actions, see
Section A.9.3, ADF Table Component Actions. At runtime, the end user can invoke any of the previously listed component actions
from an action set. The invoked component action processes all flagged rows. For example, it downloads or deletes all flagged rows. For more information about
configuring an action set to invoke a component action, see Section 8.2.2, How to
Invoke Component Actions in an Action Set.
7.11 Special Columns in the ADF Table Component
By default, the ADF Table component includes some columns when you insert an ADF Table component in a worksheet. You can retain or remove these columns, if
required. The following list describes the columns and the purpose they serve:
■
_ADF_ChangedColumn The cells in this column track changes to the rows in the ADF Table component. If
a change has been made to data in a row of the ADF Table component since download or the last successful upload, a character that resembles an upward
pointing arrow appears in the corresponding cell of the _ADF_ChangedColumn column. This character toggles appears or disappears when a user double-clicks
a cell in this column.
Figure 7–7 shows an example.
Figure 7–7 Changed Column in an ADF Table Component
A confirmation dialog appears to end users when the ADF Table component’s Download action is invoked, and one or more rows in this column are flagged as
changed. The end user clicks OK to allow the Download action to execute, or Cancel
to stop the execution of the Download action.
■
_ADF_FlagColumn When the end user double-clicks a cell in this column, the corresponding row is
flagged for flagged-row processing. A solid circle character appears to indicate that the row is flagged for flagged-row processing. For more information about
Note: If the end user does not want the ADF Table components
Upload action to upload changes in the rows flagged by this column, he or she must clear the entry that appears in the corresponding cell.
