14-8 Desktop Integration Developers Guide for Oracle Application Development Framework
parameter id=ProductNameParam parameters
■
Add an invokeAction and a method action binding so that the page definition file associated with the worksheet initializes correctly.
The following example shows the initializeProductTable invokeAction invoking the filterByProductName method action binding. The
invokeAction is refreshed only when a value for ProductNameParam is supplied.
executables invokeAction Binds=filterByProductName id=initializeProductTable
Refresh=deferred RefreshCondition={bindings.ProductNameParam = null}
... executables
The method action binding invokes a view object method filterByProductName. The view object method takes a single String
argument ProductNameArg that references the value of ProductNameParam.
bindings methodAction id=filterByProductName RequiresUpdateModel=true
Action=invokeMethod MethodName=filterByProductName IsViewObjectMethod=true DataControl=AppModuleDataControl
InstanceName=AppModuleDataControl.ProductVO1 NamedData NDName=ProductNameArg NDValue={bindings.ProductNameParam}
NDType=java.lang.String methodAction
. . . bindings
For more information about configuring a page definition file, see Section 4.3,
Working with Page Definition Files for an Integrated Excel Workbook.
14.5.3 How to Configure Parameters Properties in the Integrated Excel Workbook
You configure the workbook Parameters property and the worksheet Parameters property so that the integrated Excel workbook that the end user downloads from the
Fusion web application receives parameter values included in the query string of the workbook download URL.
To configure the workbook Parameters property: 1.
Open the integrated Excel workbook.
2. Click Workbook Properties in the Oracle ADF tab.
3. Click the ellipsis button ... beside the input field for Parameters to invoke
WorkbookParameter Collection Editor.
4. Click Add to add a new workbook initialization parameter and configure its
properties as follows:
■
Optional In the Annotation field, enter a description of the workbook initialization parameter.
■
In the Parameter field, specify the name of the URL argument that you configured for the af:goLink tag’s Destination property as described in
Section 14.5.1, How to Configure the Fusion Web Application’s Page to Pass Parameters.
Deploying Your Integrated Excel Workbook 14-9
5.
Repeat Step 4 as necessary to add other workbook initialization parameters.
6. Click OK.
For more information about the workbook Parameters property, see Table A–18
.
To configure the worksheet Parameters property: 1.
Open the integrated Excel workbook.
2. Click Worksheet Properties in the Oracle ADF tab.
3. Click the ellipsis button ... beside the input field for Parameters to invoke the
WorksheetParameter Collection Editor.
4. Click Add to add a new worksheet parameter and configure it as in
Figure 14–2 :
■
Optional In the Annotation field, enter a description of the worksheet parameter.
■
In the Parameter field, specify a parameter element that you added to the page definition file associated with the worksheet, as described in
Section 14.5.2, How to Configure the Page Definition File for the Worksheet to Receive
Parameters.
■
In the Value field, write an EL expression that references the value of the Parameter property you specified for the workbook initialization parameter
workbook Parameters array. Use the following syntax when writing the EL expression:
{workbook.params.productName} where productName references the value of the Parameter property you
specified for the workbook initialization parameter.
Figure 14–2 Worksheet Parameters
5.
Repeat Step 4 as necessary to add other workbook initialization parameters.
6. Click OK.
For more information about the worksheet Parameters property, see Table A–19
. By default, the workbook parameters are not sent every time the workbook connects to
the server to request metadata, the end user logs out, or the session expires. If
14-10 Desktop Integration Developers Guide for Oracle Application Development Framework
required, you can configure the workbook to send the initialization parameters by configuring the SendParameters property.
To configure the worksheet SendParameters property: 1.
Open the integrated Excel workbook.
2. Click Worksheet Properties in the Oracle ADF tab.
