Настройка 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_1Developer ToolsForms Builder
Настройка Forms Builder заключается в редактировании некоторых значений записей в реестре Windows, расположенных в ORACLE_HOME вашего домена WebLogic. Например, 

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

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

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

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

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

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

c:oracleMiddlewareuser_projectsdomainsClassicDomainconfigfmwconfigserversWLS_FORMSapplicationsformsapp_11.1.1config
Нас будут интересовать файлы formsweb.cfgdefault.env 

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

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

FORMS_PATH=c:myapplib;c:myappforms
В принципе после этих действий уже можно запускать формы, указанные в 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:oracleMiddlewareas_1formsjava
Указанные здесь *.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:oracleMiddlewareas_1formstemplatesconfigRegistry.dat
необходимо изменить параметр:
app.ui.lovButtons=false
на
app.ui.lovButtons=true
После редактирования этого файла необходимо перезагрузить Forms Services.

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

Leave a Reply

Your email address will not be published. Required fields are marked *