27.08.2010 Настройка WebUtil для Oracle Forms Services 11g

Основные настройки Forms Builder и Forms Services были описаны в предыдущей статье Настройка Oracle Forms Services 11g для Oracle WebLogic. Многие приложения на Oracle Forms используют WebUtil для выполнения различных операций с файлами операционной системы. Также вместе с WebUtil можно установить пакет Jacob, который позволяет выполнять COM (OLE) операции в Windows клиентах. Ниже описывается процесс настройки WebUtil для Oracle Forms Services 11g, который запускается под сервером приложений Oracle WebLogic.

Установка Jacob (Java COM BRIDGE)

Для полноценной работы WebUtil необходимо установить компонент Jacob, который можно скачать на sourceforge.net

Необходимо скопировать файл jacob.jar в каталог

c:\oracle\Middleware\as_1\forms\java

Настройка WebUtil для Oracle Forms Builder

WebUtil поставляется вместе с Oracle Forms Services. Для использования WebUtils в среде разработки необходимо установить в базу данных вашего приложения PL/SQL пакет WEBUTIL_DB, исходный код которого находится в файле

c:\oracle\Middleware\as_1\forms\create_webutil_db.sql

В зависимости от архитектуры вашего приложения вы можете установить этот пакет в схему вашего приложения или же создать отдельного пользователя- владельца этого пакета, добавить публичный синоним на этот пакет и дать на него соответствующие гранты. В этом случае пакет может быть использован различными приложениями в одной базе данных.

Для разработки форм в Forms Builder 11g в этом же каталоге находятся файлы webutil.pll и webutil.olb, представляющие собой набор PL/SQL функций библиотеки WebUtil и объектную библиотеку. Эти файлы должны быть доступны а FORMS_PATH в реестре Window (Например, HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_OH1416024141). Рекомендуется поместить эти файлы в каталог вашего приложения вместе с другими библиотеками. webutil.pll необходимо скомпилировать.

По умолчанию параметр реестра Windows FORMS_BUILDER_CLASSPATH уже настроен на использование *.jar файла frmwebutil.jar, который должен находиться в каталоге

C:\oracle\Middleware\as_1\forms\java\frmwebutil.jar.

Если вы установили jacob.jar, то необходимо

путь к нему указать в FORMS_BUILDER_CLASSPATH.

Документация на WebUtil находится в дистрибутиве, скачать который можно с сайта Oracle. Что либо дополнительно устанавливать с этого дистрибутива не следует, так как WebUtil полсностью поставляется вместе с Oracle Forms Services 11g (кроме jacob.jar).

Настройка WebUtil для Oracle Forms Services

Для поддержки WebUtil в ваших приложениях в Forms Services необходимо отредактировать конфигурационные файлы в каталоге:

c:\oracle\Middleware\user_projects\domains\ClassicDomain\config\fmwconfig\servers\WLS_FORMS\applications\formsapp_11.1.1\config\

В файле formsweb.cfg в секции вашего приложения (например, [myapp]) необходимо добавить следующие строчки:

WebUtilArchive=frmwebutil.jar,jacob.jar
WebUtilLogging=off
WebUtilLoggingDetail=normal
WebUtilErrorMode=Alert
WebUtilDispatchMonitorInterval=5
WebUtilTrustInternal=true
WebUtilMaxTransferSize=16384

В файле myapp.env в CLASSPATH должна присутствовать ссылка на frmwebutil.jar:

C:\oracle\Middleware\as_1\forms\java\frmwebutil.jar

Также должен быть указан путь к конфигурационному файлу WebUtil:

WEBUTIL_CONFIG=C:\oracle\Middleware\asinst_1\config\FormsComponent\forms\server\webutil.cfg

Если вы создавали myapp.env на основании default.env, то там эти параметры уже были указаны.

После этого ваше приложение на стороне сервера настроено на поддержку WebUtil. В процессе передачи файлов с сервера клиенту через WebUtil вы можете встретить ошибку WUT-121: