Справочник ОПФ

Модуль list-olf предназначен для управления «Справочником организационно-правовых форм» (ОПФ) на платформе JaBricks. Интерфейс формы справочника локализован для нескольких языков и позволяет просматривать добавлять, изменять и удалять записи. Справочник ОПФ может функционировать в виде диалогового окна JDialog или в виде панели JPanel, которую можно встраивать в контейнер главного фрейма, либо в контейнер другого бандла.

Графический интерфейс справочника ОПФ в виде диалогового окна, представленный на первом скриншоте, включает таблицу, настраиваемый сепаратор и поля записи. Сепаратор позволяет перераспределить пространство между таблицей и полями записей.

При выделении в таблице одной из записей её параметры отображаются в полях формы. Параметры записи можно изменить и сохранить, либо изменить и добавить как новую запись, либо удалить.

Интерфейс справочника в виде панели, представленный на следующем скриншоте, не имеет нижней панели с кнопкой закрытия диалогового окна. Кроме этого, в верхней части интерфейса можно дополнительно показать титульную панель с заголовком. Справа в титульной панели располагается иконка в виде подсвечиваемого при наведении курсором крестика, нажатие на который закрывает панель.

Настройка титульной панели

Бандл list-olf-1.0.0.jar содержит файл properties/settings.properties, контент которого представлен ниже :

title.panel.draw=true
title.panel.height=28
title.panel.background=216,216,216
title.panel.button.close=true
 

Настройки в файле settings.properties представлены в формате ключ=значение :

• title.panel.draw — флаг представления в интерфейсе титульной панели; при значении false, титульная панель не отображается.
• title.panel.height — высота титульной панели в пикселях.
• title.panel.background — цвет фона титульной панели в формате RGB.
• title.panel.button.close — флаг представления расположенной справа иконки закрытия панели.

Интерфейсные настройки

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

Поля записи

Наименование и Наименование полное
Поля «Наименование» и «Наименование полное» являются обязательными для заполнения. Дублирование значений полей не допускается.

Примечание
Поле «Примечание» не является обязательным.

Активность
Запись можно активировать/деактивировать. Флаг активности позволяет показать/скрыть справочные записи в связанных формах.

Локализация интерфейса и данных

Интерфейсная форма, предупреждающие сообщения и данные справочника ОПФ локализованы. Модуль list-olf подписан на рассылку сообщения по смене текущего языка локализации jabricks/LocaleEvent. Изменение в приложении JaBricks текущего объекта локализации Locale автоматически переведет интерфейс справочника и данные на новый язык локализации без перезагрузки. Локализованные ресурсы интерфейса модуля включены в бандл. Значение текущего языка локализации модуль получает в утилите управления внешними ресурсами util-resources. Модуль включает три языка локализации : русский, английский, немецкий.

Справочная таблица БД

Записи справочника хранятся в базе данных (БД) в таблице jbt_org_legal_forms. Для установления связи с сервером БД list-olf использует модуль util-db, позволяющего взаимодействовать с несколькими разнотипными SQL-серверами.

Модуль list-olf включает методы создания таблицы и инициализации справочных записей. При первом (после инсталляции в приложение) старте модуля в БД создается таблица jbt_org_legal_forms, в таблицу записываются инсталляционные справочные данные. При последующем использовании справочника ОПФ выполняется только проверка наличия таблицы jbt_org_legal_forms в соответствующей структуре БД. Инсталляционные справочные записи ОПФ модуль загружает в БД из внешнего файла data.init/list_olf.txt.

Примечание :
1. Справочник ОПФ следует использовать совместно с другими рабочими таблицами.
2. Чтобы случайным образом не удалить связанную запись ОПФ необходимо использовать ключи Foreign Key во внешних таблицах.

Выполнение транзакций

Перед добавлением или обновлением записи выполняется проверка заполнения обязательных полей и дублирования записей. Если одно из обязательных полей не будет заполнено, либо будут найдены дублирующие записи, то выполнение операции будет прервано выводом соответствующего сообщения в дополнительном диалоговом окне. Не допускается дублирование записей полей «Наименование» и «Наименование полное».

Добавление записи

Чтобы добавить новую запись необходимо заполнить поля формы и нажать кнопку «Добавить».

Обновление записи

Чтобы обновить какую-либо запись необходимо выделить её в таблице, внести изменения в поля формы и нажать кнопку «Сохранить».

Удаление записи

Удаление можно выполнить только после получения подтверждения. Т.е. после выделения записи и нажатии на кнопку «Удалить» модуль откроет окно подтверждения выполнения указанной транзакции.

Зависимости

Модуль list-olf версии 1.0.0 связан со следующими бандлами платформы JaBricks :

• util-resources; модуль предоставляет текущую Locale для локализации интерфейса, данных и сообщений при выполнении транзакций;
• util-db; модуль используется для установления соединения с сервером БД, проверки наличия справочной таблицы jbt_olf, выполнения операций чтения, записи, обновления и удаления.
• gui-widgets; модуль с компонентами определения интерфейса формы.
• base-universal; базовый модуль определения типа интерфейса в виде всплывающего диалогового окна или встраиваемой панели.

Справочник ОПФ версии 1.0.0, связанный с базовым модулем base-universal, требует при старте определение параметра guimode для выбора типа интерфейса (JDialog, JPanel). Параметр guimode определяется в XML-структуре описания главного меню приложения или панели инструментов. Подробнее об этом представлено в описании использования модуля base-universal на странице Урок 14 и на странице примера templ-universal с комментариями к исходным кодам.

Подключение модуля list-olf

Для подключения модуля list-olf в приложение JaBricks необходимо :

• разместить модуль в поддиректории «configuration/bundles»;
• внести в файл инициализации бандлов «bundles.ini» запись «list-olf-1.0.0.jar»
• определить пункт меню и/или кнопку панели инструментов, параметрами подключения которых указать GAV значения бандла list-olf.

GAV параметры модуля list-olf имеют следующие значения :

Подробнее о включении модуля в приложение Jabricks представлено здесь.

Рассмотренный на странице модуль упакован в архивный файл list-olf.zip, имеющий размер 39 Кб. В архив модуля включен файл с инициализационными справочными записями data.init/list_olf.txt.