Log on to the Fusion Web Application from an Integrated Excel Workbook Download Rows of Data About Product Pricing

Introduction to the ADF Desktop Integration Sample Application 2-7 Figure 2–4 Basic Search Tab in the Master Price List Fusion Web Application The Advanced Search tab enables you to find products by category, and if required, search among discontinued products by selecting the Include Discontinued Products checkbox. Figure 2–5 Advanced Search Tab in the Master Price List Fusion Web Application

2.4 Overview of the Integrated Excel Workbooks in the Master Price List Module

The Master Price List module provides the EditPriceList.xlsx, AdvEditPriceList.xlsx, and ReadOnlyPriceList.xlsx integrated Excel workbooks. All workbooks enable end users to: ■ Log on to the Fusion web application from the workbook ■ Download rows of data about product pricing ■ Search the workbook for information about product pricing In addition, the EditPriceList.xlsx and AdvEditPriceList.xlsx workbooks permit end users to: ■ Search the Master Price List module Fusion web application for information about products and product pricing ■ Modify product pricing information in the workbook ■ Use Excel formulas to perform calculations on values in an ADF Table component ■ Upload modified product pricing information to the Master Price List module Fusion web application from the workbook Subsequent sections in this chapter provide more information about the functionality in the workbooks along with cross-references to implementation details.

2.4.1 Log on to the Fusion Web Application from an Integrated Excel Workbook

At runtime, the integrated Excel workbooks in the Master Price List module render an Excel ribbon tab that allows end users to log on to the Fusion web application. Figure 2–6 shows the runtime Fusion Order Demo tab in the Ribbon of the EditPriceList.xlsx workbook. 2-8 Desktop Integration Developers Guide for Oracle Application Development Framework Figure 2–6 Runtime Fusion Order Demo Tab The EditPriceList.xlsx workbook prompts the end user to log on to the Fusion web application when the end user clicks Login or invokes an action that requires a connection with the Fusion web application. Because the worksheet Startup event in the EditPriceList.xlsx workbook invokes the ADF Table component Download action, end users are prompted to log on immediately after starting up the EditPriceList.xlsx workbook. The Login button invokes the workbook Login action. For information about configuring the Login button and other buttons in Figure 2–6 , see Section 8.3, Configuring the Runtime Ribbon Tab. The workbook Login action invokes the Fusion web application’s authentication process. For more information about implementing this functionality, see Chapter 11, Securing Your Integrated Excel Workbook. The Master Price List module provides two user profiles to log in to the application, as summarized in Table 2–2 .

2.4.2 Download Rows of Data About Product Pricing

The EditPriceList.xlsx workbook uses an ADF Table component to host information downloaded from the Fusion web application about product pricing. This component allows end users to edit rows and upload modified rows to the Fusion web application. The following sections provide information about how to implement the download functionality: ■ Each worksheet that you integrate with a Fusion web application requires an associated page definition file. The Price List worksheet in the EditPriceList.xlsx workbook is associated with the ExcelPriceListPageDef.xml page definition file. In JDeveloper, expand the following nodes in the Application Navigator to view this file: ViewController Application Sources oracle.foddemo.masterpricelist view pageDefs For information about how to configure a page definition file, see Section 4.3, Working with Page Definition Files for an Integrated Excel Workbook. ■ The ADF Table component Download action downloads data from the Fusion web application to the worksheet. For information about how you invoke this action, see Section 7.6, Configuring Oracle ADF Component to Download Data to an ADF Table Component. ■ In the EditPriceList.xlsx workbook, the worksheet Startup event invokes an action set that includes the ADF Table component Download action. For information about configuring worksheet events, see Section 8.2.4, How to Invoke an Action Set from a Worksheet Event. The ReadOnlyPriceList.xlsx workbook uses an ADF Read-only Table component to download data from the Fusion web application about product pricing. Introduction to the ADF Desktop Integration Sample Application 2-9 End users can view this data, but they cannot modify data or save changes to the Fusion web application. The following sections provide information about how to implement the download functionality of the ReadOnlyPriceList.xlsx workbook: ■ For information about creating an ADF Read-only Table component, see Section 7.16, Creating an ADF Read-Only Table Component. ■ An ADF Button component is configured to invoke an action set that includes the ADF Read-only Table component Download action. For information about creating an ADF Button component, see Section 6.2, Inserting an ADF Button Component.

2.4.3 Simple Search for Products in the Workbooks