WebUtil Version 1.0.6 - Production Release Notes
August 2005, updated January 2009
Welcome to Oracle Forms WebUtil. This document contains the following sections:
WebUtil is a pre-packaged set of components which provide client-server type functionality in Web-deployed Oracle Forms applications. WebUtil allows Forms developers to selectively execute code on the client machine rather than on the application server. WebUtil uses Pluggable Java Components to extend the Forms client, and PL/SQL to provide a simple interface for using them. Therefore, no Java skill is required to use WebUtil.
This patch release of WebUtil is tested with Oracle Forms 10gR2 (10.1.2) but 10.1.2 includes a version of WebUtil that should be used. There is no reason to download this version, 1.0.6 if you are using 10.1.2 of Developer Suite. It can also be used with Oracle Forms 10g (9.0.4) or Oracle9i Forms (9.0.2) with a few changes.
WebUtil is a fully supported component of Oracle Forms. Support issues can be raised through the usual support channels.
The following is a list of significant bug fixes since WebUtil 1.0.5. Some bugs for this release may not be relevant to prior releases.
This release of WebUtil addresses certain security issues with the signed WebUtil Jar file. The new frmwebutil.jar contains a text file named oracle.forms.webutil.common.TrustedDomains.txt. Each line in this text file represents a trusted domain name from where WebUtil can be downloaded and deployed on the client browser. The domain name in the text file may contain * (asterisk) as a wild card to match a set of domains. If any one of the lines or names matches the URL from where WebUtil is downloaded and deployed, then the URL is considered as a trusted site. Otherwise, WebUtil throws a SecurityException (error WUC-27) and Forms execution terminates.
For this security patch to work, edit the oracle.forms.webutil.common.TustedDomains.txt according to their needs and add it to frmwebutil.jar before signing it. For backwards compatibility, this file has *, which will match for everything. A URL is assumed to be trusted if either of the following conditions is met.
WebUtil works in the client, middle, and database tiers. The WebUtil User's Guide, which is shipped in the /doc directory of this distribution, contains detailed information for installing and configuring WebUtil. The base directory to which the zip file must be extracted is /forms or /forms90. Use the handy checklist in Appendix A to guide you. Before installing WebUtil, make sure you have the following:
Additional WebUtil Installation Steps
In Forms DS 10.1.2.0.2, almost all the required configurations are done by the Oracle Universal Installer itself, except for the part related to jacob. This section provides generic steps required for configuring Oracle Application Server Forms Services 10g (10.1.2) to deploy WebUtil. Use this list along with the installation checklist in Appendix A of WebUtil User's Guide.
WebUtil 1.0.6 could work with Oracle Forms 9.0.4 without any change. However, many of the executable and directory names in Oracle Forms 10.1.2, such as "/forms90/", have been renamed to "/forms/". You'll need to replace every occurrence of "/forms/" in webutil*.htm files with "/forms90/" for WebUtil to work with Forms 9.0.4. The naming conventions in Oracle Forms 9.0.4 and 10.1.2 also differ, such as f90webutil.jar to frmwebutil.jar. In Oracle Forms 9.0.2, you may need to make more changes. For instance, webutil.pll may not compile in Oracle Forms 9.0.2, particularly for the packages beginning with JAVA_. Such packages are imported from Java classes using the Oracle Forms Java Importer. You'll have to re-import them and rename the packages accordingly.
For existing users of WebUtil 1.0.5 or earlier, notice the change in the directory structure. While WebUtil 1.0.5 was installed into a new directory, WebUtil 1.0.6 directory structure duplicates the Oracle Forms installation directory structure that is present in Oracle Developer Suite 10g (101.2), and is meant for installing over the WebUtil directory that exists in the Forms installation. However, you can always install WebUtil 1.0.6 into a new directory provided that the changes in the path for some of the variables such as FORMS_PATH in default.env and archive strings in formsweb.cfg are changed accordingly.