I
End User Actions I-1
I
End User Actions
This appendix describes the actions your end user would be performing while using your application and integrated Excel workbook.
The actions described in this appendix assume that you have developed a functioning Fusion web application similar to Master Price List module. However, your
application might not support all actions provided by Master Price List module.
This appendix includes the following sections:
■
Section I.1, Installing the Runtime Edition of ADF Desktop Integration
■
Section I.2, Importing Data from a Non-Integrated Excel Worksheet
■
Section I.3, Removing Personal Information
■
Section I.4, Changing an Integrated Excel Workbook at Runtime
■
Section I.5, Limitations of Integrated Excel Workbook at Runtime
■
Section I.6, Using An Integrated Excel Workbook
I.1 Installing the Runtime Edition of ADF Desktop Integration
To enable end users to use ADF Desktop Integration and integrated Excel workbooks, you must install the Runtime edition of ADF Desktop Integration.
When you run the ADF Desktop Integration setup tool, it verifies whether required software is installed on the system. For more information about the required software,
see the following:
■
Section 3.2, Required Oracle ADF Modules and Third-Party Software
■
Section 3.3, Enabling Microsoft .NET Programmability Support
■
Section 3.4, Allowing ADF Desktop Integration to Access Microsoft Excel
To install the Runtime edition of ADF Desktop Integration: 1.
Navigate to the MW_HOME\oracle_ common\modules\oracle.adf.desktopintegration_11.1.1 directory,
where MW_HOME is the Middleware Home directory.
2.
Extract the contents of adfdi-excel-runtime-client-installer.zip to a temporary directory.
Note: JDeveloper is not required to install the runtime edition of
ADF Desktop Integration.
I-2 Desktop Integration Developers Guide for Oracle Application Development Framework
3.
Run the setup.exe file located in the extracted directory of the adfdi-excel-runtime-client-installer.zip file.
4.
Follow the instructions that appear in the dialog boxes launched by setup.exe to successfully install the required components.
5. If prompted, click Yes to restart the system and complete the setup of ADF
Desktop Integration.
Note that you cannot install both the Designer and the Runtime editions of ADF Desktop Integration on a system. You must uninstall one before installing the other
edition.
I.2 Importing Data from a Non-Integrated Excel Worksheet
End users who use the ADF Table component in an integrated Excel workbook to upload large batches of data rows to the
Fusion web application
can prepare these rows of data in a non-integrated Excel worksheet. They can then insert the data into
the ADF Table component prior to invoking the ADF Table component’s Upload action.
To prepare data in a non-integrated Excel workbook: 1.
End users arrange the layout of data in a non-integrated Excel worksheet to match the layout of the ADF Table component in the integrated Excel workbook.
For example, if an ADF Table component contains columns such as Product, Price, and Description, reproduce this layout in the non-integrated Excel
worksheet.
2.
End users use functionality of Excel to import the rows of data into the non-integrated Excel worksheet in rows under the columns arranged in Step 1.
3.
Row values that will be inserted into ADF Table component columns that use the TreeNodeList subcomponent must match a choice from the list of values.
To insert data into the ADF Table component from a non-integrated Excel workbook:
1. In the ADF Table component, end users highlight n existing downloaded rows or
new rows at the end of the ADF Table component where n is the number of rows to insert.
2. End users right-click and choose Insert from the Excel context menu.
3. In the non-integrated Excel worksheet, end users select the cells that they want to
insert into the rows of the ADF Table component created in Step 2.
Note: You cannot install the Runtime edition of ADF Desktop
Integration from JDeveloper.
Tip: Copy the column headers from the ADF Table component to the
non-integrated Excel worksheet.
Tip: Copy an ADF Table component row from the integrated Excel
workbook to another worksheet of the same workbook, as the proper constraints will be defined for such a row and can be reproduced.
End User Actions I-3
4. In the Excel menu, choose Home Copy.
5.
In the ADF Table component, select the upper left corner cell of the rows inserted in Step 2.
6. In the Excel menu, choose Home Paste. Ensure that you do not paste any value
in the Key column.
7.
End users can now invoke the ADF Table component’s Upload action using whatever functionality you configured for them as described in
Section 7.8, Configuring an Oracle ADF Component to Upload Changes from an ADF Table
Component.
I.3 Removing Personal Information
