4-10 Desktop Integration Developers Guide for Oracle Application Development Framework
To configure a new integrated Excel workbook: 1.
When you enable ADF Desktop Integration in a workbook, the Browse for Folder dialog automatically appears, as illustrated in
Figure 4–3 .
Figure 4–3 Browse For Folder Dialog
Use the Browse for Folder dialog to select the JDeveloper application home directory. In a typical JDeveloper project, the JDeveloper application home
directory stores the application_name.jws file. The value you select is assigned to the ApplicationHomeFolder workbook property.
2. In the Workbook group of the Oracle ADF tab, click Workbook Properties.
3.
In the Edit Workbook Properties dialog, set or verify the values for the following properties so that you can switch between design mode and test mode as you
configure your workbook:
■
ApplicationHomeFolder The value for this property corresponds to the absolute path for the root
directory of the JDeveloper application workspace .jws. You specified this value in Step 1.
■
Project The value for this property corresponds to the name of JDeveloper project
.jpr in the JDeveloper application workspace. To change the project, click the ellipsis ... button and choose the project from the Project dialog that lists
the projects defined in the JDeveloper application workspace.
By default, Project is set to the name of the project that contains the Excel document. ADF Desktop Integration loads the names of the available projects
Note:
The Browse for Folder dialog does not appear if the workbook is located within the JDeveloper application workspace. In such a
case, the value of ApplicationHomeFolder workbook property is assigned automatically.
Note: If you are opening the Excel file after moving your application
directory, ensure that the ApplicationHomeFolder property’s value reflects the correct path.
Preparing Your Integrated Excel Workbook 4-11
from the application_name.jws specified as a value for ApplicationHomeFolder.
■
WebAppRoot Set the value for this property to the fully qualified URL for the web context
root that you want to integrate your desktop application with. The fully qualified URL has the following format:
http:hostname:portnumbercontext-root In JDeveloper, you specify the web context root context-root in the Java
EE Application page of the Project Properties dialog. Figure 4–4
shows the web context root for the Master Price List module.
Figure 4–4 Setting Web Context Root in JDeveloper
Note that the fully qualified URL is similar to the following if you set up a test environment on your system using the Master Price List module:
http:127.0.0.1:7101FODMasterPriceList For information about how to verify that the Fusion web application is online
and that it supports ADF Desktop Integration, see Section C.1, Verifying That
Your Fusion Web Application Supports ADF Desktop Integration. If you are integrating an Excel file with a secure Fusion web application, it is
recommended that you use the https protocol while entering WebAppRoot’s value. For more information about securing your Fusion web application, see
Oracle Fusion Middleware Programming Security for Oracle WebLogic Server.
■
WebPagesFolder Set the value for this property to the directory that contains web pages for the
Fusion web application. The directory path should be relative to the value of ApplicationHomeFolder. For example, in the EditPriceList-DT.xlsx
workbook, WebPagesFolder is set to ViewController\public_html.
4-12 Desktop Integration Developers Guide for Oracle Application Development Framework
Figure 4–5 shows an implementation of workbook properties in the Edit
Workbook Properties dialog of Master Price List module’s EditPriceList-DT.xlsx workbook.
Figure 4–5 Edit Workbook Properties Dialog
4. Click OK.
