Управление динамическими атрибутами - Платформа CUBA. Руководство по разработке приложений

5.9.1.1. Управление динамическими атрибутами

Управление категориями и описаниями атрибутов осуществляется с помощью специальных экранов, доступных через меню Administration → Dynamic Attributes.

Рисунок 28. Экран списка категорий

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

Рисунок 29. Экран редактирования категории

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

Рисунок 30. Локализация имени категории

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

Рисунок 31. Редактор динамического атрибута

Для всех типов значения, кроме Boolean, доступно поле Width, позволяющее задать ширину поля в FieldGroup в пикселах или процентах. Если поле Width не заполнено, его значение по умолчанию равно 100%.

Для всех типов значения, кроме Boolean и Enumeration, также доступен чекбокс Is collection. Он позволяет создавать динамические атрибуты выбранного типа со множеством значений.

Для всех типов значения поддерживается локализация имени атрибута:

Рисунок 32. Локализация динамического атрибута

Если выбран тип значения Enumeration, множество значений перечисления задаётся в поле Enumeration в редакторе списка.

Рисунок 33. Редактор динамического атрибута для типа значений Enumeration

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

Рисунок 34. Локализация динамического атрибута для типа значений Enumeration

Динамический атрибут также имеет настройки видимости, описывающие, на каких экранах его нужно отображать. По умолчанию атрибут не отображается нигде.

Рисунок 35. Настройки видимости динамического атрибута

Кроме экрана можно также указать компонент, в котором атрибут должен появляться (например, для экранов, где несколько компонентов FieldGroup показывают поля одной и той же сущности).

Если атрибут отмечен как видимый на каком-либо экране, он автоматически отобразится во всех группах полей и таблицах, отображающих объекты данного типа в данном экране.

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

Для того чтобы изменения в атрибутах и настройках видимости вступили в силу, необходимо нажать кнопку Применить изменения на экране со списком категорий. Изменения также можно применить через Administration → JMX Console, вызвав метод clearDynamicAttributesCache() JMX бина app-core.cuba:type=CachingFacade.

Ниже изображен динамический атрибут, добавленный в экран автоматически путем задания настроек отображения атрибута:

Динамические атрибуты можно добавить в экран вручную. Для этого необходимо выполнить следующее:

В секции dsContext XML-дескриптора экрана для источника данных с загружаемой сущностью (сущностями) установить в true признак loadDynamicAttributes для источника данных с загружаемой сущностью (сущностями), например:
```
<dsContext>
  <datasource id="carDs" class="com.company.sample.entity.Car" view="_local" loadDynamicAttributes="true"/>
</dsContext>
```
В описании визуального компонента в качестве property нужно использовать код динамического атрибута с префиксом +:
```
<textField id="numberOfSeats" datasource="carDs" property="+numberOfSeats"/>
```