Deploying a Published Workbook with Your Fusion Web Application

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