Adding Interactivity to Your Integrated Excel Workbook 8-21
■
The Dialog.Page property in the action set references a page that is part of your Fusion web application, but that does not need to share information with the
integrated Excel worksheet. For example, a page that displays online help information.
For more information about data control frames in a Fusion web application, see the Sharing Data Control Instances section of the Oracle Fusion Middleware Fusion
Developers Guide for Oracle Application Development Framework.
Configuring a Fusion Web Application for ADF Desktop Integration Frame Sharing
When you add the ADF Desktop Integration Technology scope to your Fusion web application, the application is automatically configured to support ADF Desktop
Integration frame sharing. Frame sharing allows each worksheet of an integrated Excel workbook to use a dedicated DataControl frame. Web pages displayed in dialogs
invoked from each worksheet can then share the same DataControl frame as the integrated Excel worksheet.
To verify that your Fusion web application is configured to support frame sharing:
1.
Open your Fusion web application project in JDeveloper.
2.
In the Application Navigator, expand the Application Resources panel.
3. Open the adf-config.xml file available in Descriptors ADF META-INF
folder.
4. Click the Source tab to open the source editor.
5.
Confirm that the following adf-desktopintegration-servlet-config element is present in the file before the adf-config tag:
adf-desktopintegration-servlet-config xmlns=http:xmlns.oracle.comadfdesktopintegrationservletconfig
controller-state-manager-class oracle.adf.desktopintegration.controller.impl.ADFcControllerStateManager
controller-state-manager-class adf-desktopintegration-servlet-config
6.
Save the adf-config.xml file and close JDeveloper.
8.5 Inserting Values in ADF Table Columns from a Web Page Pick Dialog
You can configure the DoubleClickActionSet of an ADF Table component’s column to invoke a Fusion web application page that renders a pick dialog where the
end user selects a value to insert in the ADF Table component column.
This functionality is useful when you want to constrain the values that end users can enter in an ADF Table component. For example, you may want a runtime ADF Table
component column to be read-only in the Excel worksheet so that end users cannot manually modify values to prevent them from introducing errors. Invoking a pick
dialog rendered by a Fusion web application page allows the end user to change values in the ADF Table component without entering incorrect data.
In addition to configuring the DoubleClickActionSet, you configure the ADF Table component’s RowData.CachedAttributes property to reference attribute
binding values if you want:
8-22 Desktop Integration Developers Guide for Oracle Application Development Framework
■
End users to modify values in the Fusion web application’s page that you do not want to appear in the ADF Table component of the integrated Excel workbook
■
An ADF Table component’s column to be read-only in the integrated Excel workbook
■
Cache data in an ADF Table component over one or more user sessions that is not visible to end users but is modified by a pick dialog
For example, an ADF Table component displays a list of product names to end users. A pick dialog is invoked that refreshes the list of product names in the ADF
Table component and, as part of the process, sets the value of product IDs. In this scenario, you specify the attribute binding value for the product ID in the ADF
Table component’s RowData.CachedAttributes property. After the action set executes, the ADF Table component displays the refreshed list of product names
in the rows of the Excel worksheet and references the associated product IDs in its RowData.CachedAttributes property.
For information about populating values in the pick dialog, see the Creating Databound Selection Lists and Shuttles chapter in the Oracle Fusion Middleware Fusion
Developers Guide for Oracle Application Development Framework.
To invoke a pick dialog from an ADF Table component: 1.
Open the integrated Excel workbook.
2.
Select the cell in the Excel worksheet that anchors the ADF Table component and click the Edit Properties button in the Oracle ADF tab to display the property
inspector.
3.
Configure the ADF Table component’s RowData.CachedAttributes property to reference attribute binding values.
4. Click the ellipsis button ... beside the input field for Columns to display the
TableColumn Collection Editor.
5. In the Members list, select the column from which the end user invokes the pick
dialog at runtime.
6.
Configure the DoubleClickActionSet of the UpdateComponent property, as described in
Table 8–4 .
Table 8–4 DoubleClickActionSet Properties
Add this action... To...
ADFmAction Optional Invoke the CreateInsert action binding if the end
user invokes the DoubleClickActionSet from a newly created row in the Excel worksheet’s ADF Table component. In
this scenario, the ADF Table component’s RowUpSync action invoked in the next action fails if the Fusion web application
does not contain a placeholder row.
ComponentAction Invoke the ADF Table component’s Table.RowUpSync action
to synchronize any pending changes in the current row of the ADF Table component to the Fusion web application.
Dialog Configure the Dialog action to invoke the pick dialog page
from the Fusion web application. Set the Dialog action’s ShareFrame property to True. For more information, see
Section 8.4, Displaying Web Pages from a Fusion Web Application.
Adding Interactivity to Your Integrated Excel Workbook 8-23
7. Click OK.
8.6 Creating ADF Databound Search Forms in an Integrated Excel Workbook
