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