8-18 Desktop Integration Developers Guide for Oracle Application Development Framework
8.4.1 How to Display a Web Page in a Popup Dialog
You can configure a Dialog action in an action set to invoke a web page from your Fusion web application in a modal popup dialog hosted by Excel’s web browser
control. This feature provides end users with functionality that allows them to, for example, input values displayed by a page from the Fusion web application into the
integrated Excel workbook.
The web page that the action set invokes must contain a reserved HTML Document Object Model DOM element for example, a span element that has a case-sensitive
ID attribute set to ADFdi_CloseWindow. Example 8–1
shows how you can automatically set the value of the span element in the excelAdvSearch.jspx page
of the Master Price List module using the rendered property of the f:verbatim tag.
Example 8–1 Use of HTML Document Object Model Span Element
f:verbatim rendered={requestScope.searchAction eq search} span id=ADFdi_CloseWindowContinuespan
f:verbatim f:verbatim rendered={requestScope.searchAction eq cancel}
span id=ADFdi_CloseWindowAbortspan f:verbatim
Figure 8–17 shows the excelAdvSearch.jspx page hosted by the
EditPriceList-DT.xlsx workbook’s browser control.
Figure 8–17 Advanced Search Popup Dialog
In scenarios where you cannot use the rendered property of the f:verbatim tag as outlined in
Example 8–1 , you may need to:
1. Create a backing bean that exposes the Dialog action’s result value as a property
2. Use an action listener to invoke the backing bean, and an EL expression in the
span element to set the value ADFdi_CloseWindow to the bean property value. Whichever approach you take, ADF Desktop Integration monitors the value of
ADFdi_CloseWindow to determine when to close the popup dialog. If ADFdi_ CloseWindow references:
■
An empty string or is not present, the popup dialog remains open.
Note: The HTML select components, such as list box or
dropdown list, do not follow z-order configuration when the page is displayed through Dialog actions. In the .NET Web Browser control,
on a web page with layered and overlapping components, the select components might appear on top of other components.
Adding Interactivity to Your Integrated Excel Workbook 8-19
■
Continue, the popup dialog closes and the action set invokes its next action. The following example shows ADFdi_CloseWindow assigned a value of
Continue: var closeWindowSpan = document.getElementByIdADFdi_
CloseWindow; closeWindowSpan.innerHTML = Continue;
■
Some other string value, the popup dialog remains open. You set the Target property for a Dialog action to Popup to display a web page
from the Fusion web application in a modal popup dialog hosted by Excel’s web browser control. Displaying a web page in a modal popup dialog differs from
displaying a web page in Excel’s task pane, because the Dialog action that the action set invokes cannot continue execution until it receives user input. While the popup
dialog is open, the end user cannot interact with any other part of the integrated Excel workbook, as the popup dialog retains focus.
End users can navigate between multiple web pages from the Fusion web application within the browser control until they close the browser control, or ADF Desktop
Integration closes it.
To immediately synchronize the changes that the end user makes to a data control through a popup dialog, specify the next action in the action set after the Dialog
action to download all modified bindings to the worksheet use the DownSync worksheet action or ADF Table component use the Download action. This scenario
assumes that you specify Continue as the value for ADFdi_CloseWindow.
8.4.2 How to Display a Web Page in ADF Desktop Integration Runtime Task Pane
