Справочник единиц измерения

Модуль list-measures версии 3.0.3 предназначен для управления справочником «Единиц измерения» приложения на платформе JaBricks. Графический интерфейс формы справочника локализован для нескольких языков и позволяет просматривать иерархическую структуру справочника, добавлять, изменять и удалять записи. Справочник валют может функционировать в виде диалогового окна JDialog или в виде панели JPanel, которую можно встраивать в контейнер главного фрейма, либо в контейнер другого бандла.

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

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

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

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

Бандл list-measures-3.0.3.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-measures подписан на рассылку сообщения по смене текущего языка локализации jabricks/LocaleEvent. Переключение приложения с одного языка на другой автоматически переведет интерфейс на новый язык локализации. Локализованные ресурсы интерфейса модуля включают три языка локализации (русский, английский, немецкий) и включены в бандл. Значение текущего языка локализации list-measures получает в модуле ресурсов util-resources.

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

Модуль list-measures включает методы создания таблицы и инициализации справочных записей. При первом после инсталляции в приложение старте модуля в БД создается таблица jbt_measures, в таблицу записываются инсталляционные справочные данные. При последующем использовании справочника единиц измерения выполняется только проверка наличия таблицы в структуре БД. Для взаимодействия с сервером БД list-measures использует модуль util-db, либо один из его прототипов.

Примечание :
1. Справочник единиц измерений следует использовать совместно с другими рабочими таблицами, связанными с товаром.
2. Чтобы случайным образом не удалить связанную запись единицы измерений необходимо использовать внешние ключи Foreign Key в дочерних таблицах.
3. Структура таблицы jbt_measures включает уникальный индекс (Unique Index) поля «Наименование», не допускающий дублирование записей.

Блокированные записи

Инсталляционные записи групп «Базовые» и «Производные» блокированы на уровне таблицы БД (поле locked). Эти записи можно редактировать, но нельзя удалить через интерфейс. Флаг блокировки записи в интерфейсе не представлен. При попытке удаления блокированной записи через интерфейс модуль выдаст сообщение о невозможности выполнения данной операции. Снять блокировку можно непосредственно в таблице БД, используя соответствующий IDE.

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

Перед выполнением транзакции модуль list-measures проводит все необходимые проверки. Перед добавлением или обновлением записи выполняется проверка заполнения обязательного поля (наименование) и дублирования записей (наименование, обозначение). Если обязательное поле не будет заполнено, либо будут найдены дублирующие записи, то выполнение операции будет прервано выводом соответствующего сообщения.

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

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

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

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

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

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

При удалении записи выполняется проверка наличия дочерних записей (для группы) и флага блокирования записи. Если запись не может быть удалена, то будет открыто окно с сообщением о невозможности выполнения данной операции, в противном случае будет открыто окно подтверждения удаления записи. При получении положительного ответа запись удаляется из таблицы БД.

Зависимости

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

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

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

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

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

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

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

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

Рассмотренный на странице модуль list-measures-3.0.3.jar имеет размер 41 Кб.