Действия компонентов выбора сущностей

Действия компонентов выбора сущностей работают с содержимым компонентов entityPicker и entityComboBox. Эти компоненты реализуют интерфейс EntityPickerComponent.

Когда действие добавляется в компонент выбора сущностей, оно автоматически представляется кнопкой внутри поля.

Например:

<entityPicker id="departmentEntityPicker"
              dataContainer="userDc" property="department" width="20em">
    <actions>
        <action id="entityLookup" type="entity_lookup"/>
        <action id="entityOpen" type="entity_open"/>
        <action id="entityClear" type="entity_clear"/>
    </actions>
</entityPicker>
entity picker actions 1

Далее приведены типы стандартных действий компонентов выбора сущностей.

entity_clear

Класс действия: EntityClearAction

Очищает значение компонента.

Если компонент отображает сущность one-to-one композиции, экземпляр сущности будет удален при сохранении DataContext (в экране деталей сущностей это происходит при нажатии пользователем OK).

entity_lookup

Класс действия: EntityLookupAction

Выбирает экземпляр сущности используя экран списка сущностей и устанавливает выбранный экземпляр в значение компонента.

entity_open

Класс действия: EntityOpenAction

Открывает экран деталей сущности для экземпляра, установленного в компоненте.

entity_openComposition

Класс действия: EntityOpenCompositionAction

Открывает экран деталей для сущности one-to-one композиции, установленной в компоненте. Если в данный момент связанной сущности нет (компонент пуст), то создается новый экземпляр и затем сохраняется открывающимся экраном деталей.

entity_read

Начиная с Jmix 3.1

Класс действия: EntityReadAction

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