5.9.1.2. Категоризируемые сущности

Если сущность реализует интерфейс com.haulmont.cuba.core.entity.Categorized, то для работы с ее динамическими атрибутами можно использовать компонент com.haulmont.cuba.gui.components.RuntimePropertiesFrame. Этот компонент позволяет пользователю выбрать для экземпляра сущности некоторую категорию и указать значения динамических атрибутов этой категории.

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

  • В секции dsContext необходимо объявить два источника данных:

    • runtimePropsDatasource - специфический источник, в который будут загружены экземпляры CategoryAttributeValue. Атрибут mainDs должен ссылаться на главный источник данных, содержащий редактируемую сущность.

    • обычный collectionDatasource для загрузки списка категорий данного типа сущности.

      Например:

      <dsContext>
        <datasource id="carDs"
            class="com.company.sample.entity.Car"
            view="carEdit"/>
      
        <runtimePropsDatasource id="runtimePropsDs"
            mainDs="carDs"/>
      
        <collectionDatasource id="categories"
            class="com.haulmont.cuba.core.entity.Category"
            view="_local">
          <query>
               select c from sys$Category c where c.entityType='sample$Car'
          </query>
        </collectionDatasource>
      </dsContext>
  • После этого можно включить в XML-дескриптор экрана визуальный компонент runtimeProperties:

    <runtimeProperties id="runtimePropsFrame"
      runtimeDs="runtimePropsDs"
      categoriesDs="categories"/>