Introduction to ADF Desktop Integration Table-Type Components Page Definition Requirements for an ADF Table Component

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

7.1 Introduction to ADF Desktop Integration Table-Type Components

ADF Desktop Integration provides the following table-type components to display structured data: ■ ADF Table component ■ ADF Read-only Table component The ADF Table and ADF Read-only Table components provide end users the functionality to download rows of data from the Fusion web application. The ADF Table component provides additional functionality that allows end users to edit or delete the downloaded data, or to insert new rows of data. The ADF Table component’s Upload action is used to upload the resulting data. The number of rows that an ADF Table or ADF Read-only Table component contains expands or contracts based on the number of rows to download from a Fusion web application. You should not place anything to the left or right of a table-type component unless you want to replicate it when Excel inserts rows to accommodate the data that one of the table-type components downloads. You can place other components above or below a table-type component as they maintain their position relative to the table-type component at runtime. End users who want to insert new rows of data into an ADF Table component at runtime must insert full rows into the Excel worksheet that hosts the ADF Table component. Each ADF Table component contains a Key column. Do not remove the Key column as it contains important information that is used by ADF Desktop Integration for proper functioning of the table. Removal of the Key column, or any modification in the Key column cell, results in errors and data corruption. For more information about the Key column, see Section 7.12, Configuring ADF Table Component Key Column. The other ADF Desktop Integration components that you can use with these table-type components are described in Chapter 6, Working with ADF Desktop Integration Form-Type Components.

7.2 Page Definition Requirements for an ADF Table Component

The ADF Table component is one of the Oracle ADF components that ADF Desktop Integration exposes. It appears in the components palette of the ADF Desktop Integration Designer task pane and, after inserted into an Excel worksheet, allows the following operations: ■ Read-only ■ Insert-only ■ Update-only ■ Insert and update Review the following sections for information about page definition file requirements specific to an ADF Table component. Before you can configure an ADF Table component to provide data-entry functionality to your end users, you must configure the underlying page definition file for the Excel worksheet with ADF bindings. For general information about the page definition file requirements for an integrated Excel workbook, see Section 4.3, Working with Page Definition Files for an Integrated Excel Workbook. Expose the following control bindings when you create a page definition file for authoring an ADF Table component: Working with ADF Desktop Integration Table-Type Components 7-3 ■ Tree binding that exposes desired attribute bindings and a tree binding attribute that uniquely identifies each row in the table. ■ Method action bindings and action bindings if you intend to configure values for the ADF Table component’s RowActions and BatchOptions groups of properties. Examples of procedures where you set values for these groups of properties include: – Section 7.3, Inserting an ADF Table Component into an Excel Worksheet