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

После установки Oracle WebLogic Server и Oracle Forms Services необходимо настроить Forms Builder и Forms Services для разработки и запуска приложений.

Настройка Forms Builder

Forms Builder 11g запускается из меню Windows Start->All programs->Oracle Classic Instance -ainst_1\Developer Tools\Forms Builder

Настройка Forms Builder заключается в редактировании некоторых значений записей в реестре Windows, расположенных в ORACLE_HOME вашего домена WebLogic. Например,

HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_OH1416024141

Прежде всего необходимо настроить параметр NLS_LANG, который отвечает за язык интерфейса и кодировку, используемые в формах. Например

AMERICAN_AMERICA.CL8MSWIN1251

Далее настраивается параметр реестра FORMS_PATH, где прописываются пути к библиотекам *.pll, меню *.mmb, формам *.fmb. Пример

c:\myapp\lib;c:\myapp\forms

Если в вашем приложении используются PJC модули (Pluggable Java Component), то путь к *.jar файлам PJC компонентов необходимо прописать в параметре реестра FORMS_BUILDER_CLASSPATH

Необходимо помнить, что все эти параметры влияют только на Forms Builder и не влияют на Forms Services.

После этих действий Forms Builder 11g можно считать настроенным и можно переходить к настройке Forms Services.

Минимально необходимые настройки Oracle Forms Services

Конфигурационные файлы, которые нам необходимо настроить, находятся с каталоге:

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

Нас будут интересовать файлы formsweb.cfg, default.env

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

[myapp]
envFile=myapp.env

Далее создаем текстовый файл с именем myapp.env как копию файла default.env и добавляем в него параметр FORMS_PATH - через точку с запятой указываем пути, в которых располагаются компилированные файлы PL/SQL библиотек *.plx , меню *.mmx, форм *.fmx. Пример:

FORMS_PATH=c:\myapp\lib;c:\myapp\forms

В принципе после этих действий уже можно запускать формы, указанные в FORMS_PATH в браузере (сервер WLS_FORMS должен быть запущен) указав URL вида:

http://mobile:9001/forms/frmservlet?config=myapp&form=main

Если Forms Services работает правильно и у вас есть скомпилированная форма (при помощи последней версии Forms Builder или Forms Compiler, соответствующие версии Forms Services), указанная в URL (в нашем примере main.fmx), то вы увидите в браузере работающую форму.

Дополнительные настройки Oracle Forms Services

Дополнительные параметры приложения могут быть указаны как для файла formsweb.cfg так и для файла myapp.env. Приведем некоторые наиболее важные из них.

Дополнительные параметры для файла formsweb.cfg

archive - перечисление ваших PJC компонентов или других *.jar файлов (например, архив с пиктограммами), которые используются в приложении. По умолчанию параметр имеет значение: archive=frmall.jar. При необходимости допишите список ваших *.jar файлов. Эти файлы должны находиться в каталоге сервера

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

Указанные здесь *.jar файлы будут однократно загружены всем клиентам в кэш Oracle при первом обращении к вашему приложению или при изменении версии файла на сервере. Пример параметра:

archive=frmall.jar,icons.jar,mypjc.jar

pageTitle - Название вашего приложения, отображается в заголовке браузера. Например:

pageTitle=Application title

lookandfeel - Стиль, в котором выводятся формы вашего приложения. Может принимать значения Oracle или Windows. Например:

lookandfeel=Oracle

colorScheme - Цветовая схема или тема вашего приложения. Может принимать значения Teal, Titanium, Red, Khaki, Blue, Olive, Purple. Например:

colorScheme=Titanium

Width, Height - Высота или ширина java-апплета, в котором будет выводиться ваше приложение. Могут быть заданы как просто в пикселях, так и в процентах от размера окна браузера. Например:

Width=100%
Height=100%

separateFrame - Загружать приложение в отдельном окне браузера, если TRUE, иначе в том же окне. По умолчанию FALSE. Пример:

separateFrame=TRUE

Дополнительные параметры для файла myapp.env

CONNECT_STRING - имя базы данных по умолчанию при выполнении логина клиентом в вашем приложении. Например:

CONNECT_STRING=orcl

NLS_LANG - Языковые параметры, территория и кодировка, которые должен использовать сервер. Например:

NLS_LANG=RUSSIAN_CIS.CL8MSWIN1251

NLS_NUMERIC_CHARACTERS - Числовые параметры. Разделитель целой и дробной части числа и разделитель разрядов в числах. Например:

NLS_NUMERIC_CHARACTERS=.,

REP_SERVER_URL - URL сервера отчетов Reports Services. Например:

REP_SERVER_URL=http://mobile:9002/reports/rwservlet

REP_SERVER_NAME - Имя сервера отчетов, к которому должно обращаться ваше приложение. Например:

REP_SERVER_NAME=rep_wls_reports_mobile_asinst_1

FORMS_MMAP - По умолчанию включен (TRUE). Параметр, позволяющий серверу загружать однократно файлы форм в память для всех пользователей, что уменьшает использование памяти сервером и увеличивает производительность. Однако при разработке это неудобно, так как в случае занятости формы клиентом не позволяет изменить исполняемый файл, так как он в этом случае заблокирован. Если выставить этот параметр в FALSE, то для каждого клиента загружается своя версия исполняемого файла формы. При этом не происходит блокировка файла, что позволяет перекомпилировать новую версию файла формы даже в том случае, если этот файл используется другими клиентами. Очень удобно при разработке, однако на продуктивных серверах рекомендуется оставлять этот параметр включенным для максимальной производительности. Пример использования для среды разработки:

FORMS_MMAP=FALSE

В файле myapp.env возможно указание любых пользовательских параметров приложения, значения которых могут быть прочитаны в формах приложения. Например:

EXT_APP_SERVER_URL=http://localhost:7777/ext_app/

LOV Buttons

Если в ваших формах используются списки значений LOV (List of Values), то в интерфейсе по умолчанию отключена кнопка выбора значения, которая появляется при получении фокуса в поле с LOV. Непонятно, почему сделана такая настройка по умолчанию, но мы можем включить показ этой кнопки, отредактировав файл:

c:\oracle\Middleware\as_1\forms\templates\config\Registry.dat

необходимо изменить параметр:

app.ui.lovButtons=false

на

app.ui.lovButtons=true

После редактирования этого файла необходимо перезагрузить Forms Services.

В статье были описаны некоторые базовые настройки Oracle Forms Services. Более подробно с настройкой Forms Services можно ознакомиться в официальной документации: Configuring and Managing Forms Services

www.foxbase.ru