3-6 Desktop Integration Developers Guide for Oracle Application Development Framework
3.7.1 How to Migrate an Integrated Excel Workbook to the Current Version of ADF Desktop Integration
When you open the integrated Excel workbook after upgrading the ADF Desktop Integration add-in, the add-in detects and compares the ADF Desktop Integration
version information of the workbook with the version installed on the client system. If required, you are asked to upgrade the metadata of the integrated workbook to the
version installed on the client.
To migrate an integrated Excel workbook after upgrading: 1.
Open the integrated Excel workbook. The Migrate Workbook dialog prompts you to migrate the workbook to the
current version of ADF Desktop Integration, as shown in Figure 3–1
.
Figure 3–1 Migrate Workbook Dialog
If you get one or more Microsoft Office Customization Installer error messages when you open the integrated Excel workbook, ignore the messages and continue.
The error messages appear because ADF Desktop Integration cannot remove the old version information from the workbook before Excel detects it and reports the
error.
2. Click Yes to migrate the workbook. The ADF Desktop Integration migration
process closes the workbook and then reopens it, ready to be used with the current version of ADF Desktop Integration.
3.8 Using ADF Desktop Integration on a System with Multiple Instances of JDeveloper
You can have only one active installation of ADF Desktop Integration on a given system. By default, when you install JDeveloper, ADF Desktop Integration is extracted
to MW_HOME\jdeveloper\adfdi . If you decide to move to another version of JDeveloper in a different directory, you must remove the old version of ADF Desktop
Integration, as described in
Section 3.6, Removing ADF Desktop Integration. You
must then set up ADF Desktop Integration with the new version of JDeveloper that you are moving to, as described in
Section 3.5, Installing ADF Desktop Integration. Alternatively, you can set up ADF Desktop Integration in a directory that is
independent of your JDeveloper installation. This approach means that you do not have to remove ADF Desktop Integration before moving to a newer version.
Note: If you do not uninstall the old version of ADF Desktop
Integration add-in, an error occurs unless the new installer is in the exact same location as the old installer.
Setting Up Your Development Environment 3-7
To set up ADF Desktop Integration in an independent directory: 1.
Create a directory independent of the JDeveloper installation directory. For example, you may create the following directory:
D:\adfdi-excel-setup
2.
When you move to a newer version of JDeveloper, copy the contents of the following directory:
MW_HOME \jdeveloper\adfdi\bin\excel\addin\designer
to: D:\adfdi-excel-setup
where MW_HOME is the the Middleware Home directory.
3.
Run the setup.exe tool located in D:\adfdi-excel-setup.
4.
Follow the instructions that appear in the dialog boxes launched by setup.exe to set up the new version of ADF Desktop Integration.
5. If prompted, click Yes to restart the system and complete the setup of ADF
Desktop Integration.
3.9 Localizing the Setup of Visual Studio Tools for Office
Follow the instructions in this section to localize the setup of Visual Studio Tools for Office. By default, the installer described in
Section 3.5, Installing ADF Desktop Integration
, runs in English. You can download and install a different language pack from the Microsoft Download Center for the language that you want to appear when
the installer runs. This section assumes that no instance of ADF Desktop Integration is present on your
system and that your system uses a non-English version of the operating system. If ADF Desktop Integration is present, remove it as described in
Section 3.6, Removing ADF Desktop Integration.
For information about supported operating systems, see Section 3.2, Required Oracle
ADF Modules and Third-Party Software.
To localize the setup of Visual Studio Tools for Office: 1.
Download the appropriate language pack for example, French for Microsoft Visual Studio Tools for Microsoft Office from the Microsoft Download Center at:
http:www.microsoft.comdownloads
2.
Install the language pack that you downloaded in Step 1.
3.
Set up ADF Desktop Integration, as described in Section 3.5, Installing ADF
Desktop Integration.
WARNING: After you install ADF Desktop Integration, do not
delete the directory where you copied the setup files. You can delete the files after removing ADF Desktop Integration from the system.
3-8 Desktop Integration Developers Guide for Oracle Application Development Framework
4
Preparing Your Integrated Excel Workbook 4-1
4
Preparing Your Integrated Excel Workbook
This chapter describes preparatory tasks that you must perform in developing your Fusion web application so that you can integrate an Excel workbook with the finalized
application. This chapter also describes how you configure an Excel workbook before you add Oracle ADF functionality, using the tools provided in the ADF Desktop
Integration module.
This chapter includes the following sections:
■
Section 4.1, Introduction to Preparing Your Integrated Excel Workbooks
