14-4 Desktop Integration Developers Guide for Oracle Application Development Framework
14.4 Deploying a Published Workbook with Your Fusion Web Application
Add the integrated Excel workbook to the JDeveloper project for your Fusion web application if it is not packaged with the other files that constitute your JDeveloper
project. This makes sure that the Excel workbooks you integrate with your Fusion web application get deployed when you deploy your finalized Fusion web application. For
example, the Master Price List module stores the Excel workbooks that it integrates at the following location:
FOD_ HOME\MasterPriceList\ViewController\src\oracle\foddemo\masterpri
celist\excel\excel
where FOD_HOME is the installation directory for the Fusion Order Demo application. After you decide on a location to store your integrated Excel workbooks, you can
configure web pages in your Fusion web application allowing end users to access the integrated Excel workbooks. For example,
Figure 14–1 shows Internet Explorer’s File
Download dialog, which was invoked by clicking the Excel Edit Using Live Spreadsheet
menu options on the PriceListSummary.jspx page displayed by the Master Price List module.
Figure 14–1 Invoking an Integrated Excel Workbook from a Fusion Web Application
To enable the functionality illustrated in Figure 14–1
, the HTTP filter parameters for your Fusion web application must be configured to recognize Excel workbooks.
JDeveloper automatically configures these parameters for you when you add ADF Desktop Integration to the technology scope of your Fusion web application, as
explained in Section 4.2, Adding ADF Desktop Integration to a Fusion Web
Application. If you want to manually configure the HTTP filter parameters, see
Appendix E, ADF Desktop Integration Settings in the Web Application Deployment Descriptor.
After you have configured the HTTP filter for your Fusion web application, you configure the web pages that the Fusion web application displays to end users to allow
them to invoke Excel workbooks. A basic method of invoking an Excel workbook that you have integrated with a Fusion web application is to provide a hyperlink that
invokes the workbook. For example, you could write the following HTML in a web page:
Deploying Your Integrated Excel Workbook 14-5
a href=excelEditPriceList.xlsxOpen the Master Price List in Excela
where excel is a subdirectory of the directory specified by the WebPagesFolder workbook property and EditPriceList.xlsx is the Excel workbook that the end
user invokes.
You can provide functionality that allows end users to invoke Excel workbooks from buttons, lists and ribbon command buttons. The following list provides some
examples:
■
Button Display a button on the web page that, when clicked, invokes the integrated Excel
workbook.
■
Selection list Use the ADF Faces selectOneChoice component with a button to invoke an
integrated Excel workbook.
■
Menu Use the ADF Faces goMenuItem component.
The View and Query Using Live Spreadsheet menu, as illustrated in Figure 14–1
, uses the goMenuItem component. The PriceListSummary.jspx page displays
this menu. The following entry appears in the PriceListSummary.jspx page of the Master Price List module and demonstrates the goMenuItem component:
af:goMenuItem id=goReadOnly textAndAccessKey={res[pls.productList.menu.lsr.label]}
destination=excelpublishedReadOnlyPriceList.xlsx
For more information about creating web pages for a Fusion web application, see the Oracle Fusion Middleware Web User Interface Developers Guide for Oracle Application
Development Framework.
14.5 Passing Parameter Values from a Fusion Web Application Page to a Workbook