Настройка 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. Например, 

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

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

1
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

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

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

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

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

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

1
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 файлов. Эти файлы должны находиться в каталоге сервера 

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

1
archive=frmall.jar,icons.jar,mypjc.jar
pageTitle – Название вашего приложения, отображается в заголовке браузера. Например: 

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

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

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

1
2
Width=100%
Height=100%
separateFrame – Загружать приложение в отдельном окне браузера, если TRUE, иначе в том же окне. По умолчанию FALSE. Пример:

1
separateFrame=TRUE

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

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

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

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

1
NLS_NUMERIC_CHARACTERS=.,
REP_SERVER_URL – URL сервера отчетов Reports Services. Например:

1
REP_SERVER_URL=http://mobile:9002/reports/rwservlet
REP_SERVER_NAME – Имя сервера отчетов, к которому должно обращаться ваше приложение. Например:

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

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

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

LOV Buttons

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

1
c:oracleMiddlewareas_1formstemplatesconfigRegistry.dat
необходимо изменить параметр:
app.ui.lovButtons=false
на
app.ui.lovButtons=true
После редактирования этого файла необходимо перезагрузить Forms Services.

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

Related Post

Установка Oracle WebLogic Server 11g (10.3.6) gene... На момент написания этой заметки на 64 битную операционную систему Windows можно было установить только версию WebLogic Server 10.3.6 generic, котора...
Virtual mapping for Oracle Forms Services 11g В процессе настройки Oracle Forms Se...

Leave a Reply

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