Релиз 3.1

В мастере создания экранов для экранов списка и экранов master-detail появился новый шаг, на котором выбирается способ фильтрации данных пользователями: genericFilter (по умолчанию), набор компонентов propertyFilter для выбранных атрибутов, fullTextFilter, если в проект включено дополнение Search, или отсутствие фильтра.

Дизайнер сущностей позволяет задать аннотацию @LookupField для сущности и для её ссылочных атрибутов. Мастер создания экранов учитывает эту аннотацию при генерации компонентов для ссылок.

Новое действие Views with Attribute дизайнера сущностей показывает компоненты экранов, связанные с атрибутом сущности, и открывает дескриптор экрана на выбранном компоненте. Оно также позволяет добавить атрибут в экраны сущности. Действие доступно на панели инструментов таблицы атрибутов и в каждой строке атрибута.

Новое действие Copy View создает копию экрана вместе с его контроллером, дескриптором и сообщениями.

Действие New → Advanced → Custom Component создает файлы кастомного UI-компонента: класс компонента, его XML-загрузчик и Spring-конфигурация для его регистрации. Действие также может создать XSD-схему для XML-элемента компонента, метаданные для визуального дизайнера Studio, и файл JavaScript с Lit веб-компонентом.

Диалог со списком changelog-файлов Liquibase, еще не примененных к базе данных, теперь показывает содержимое выбранного changelog-файла. С его помощью можно просматривать changelog-файлы, которые поставляются с дополнениями.

Дизайнер JPQL можно открыть с помощью иконки на левом поле редактора для запросов в LoadContext.Query и в методе setQueryString().

Инспекции Studio проверяют структуру отчетов, определенных в Java-коде и содержащих потоковый бэнд. Они сообщают о структуре, которую не поддерживает движок отчетов, например, о втором потоковом бэнде, дочернем бэнде потокового бэнда или наборе данных, отличном от SQL или JPQL.

aiChat — полноценный чат с потоковой выдачей ответов, сообщениями в формате Markdown, вложенными файлами и действиями для отдельных сообщений. Его можно связать с контейнером данных вашей собственной сущности сообщения, чтобы сохранять переписку.

aiMessageList и aiMessageInput можно использовать по отдельности, чтобы создать чат, возможности которого выходят за рамки aiChat.

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

Обработчики UI добавляют поведение экранам: это короткие выражения, которые выполняются при нажатии кнопок, изменении значений и событиях экранов и могут вызывать методы приложения, помеченные аннотацией @DynamicModelOperation.

Полнотекстовый поиск индексирует динамические атрибуты, помеченные как searchable.

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

Роль Dynamic model: modify settings without data loss позволяет пользователям применять только те изменения, которые не могут привести к потере сохранённых данных.

История модели показывает все применённые версии модели.

Можно изменять порядок атрибутов.

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

Пункты меню динамических экранов могут иметь иконку.

Кнопка Generate XML рендерит шаблон экрана в XML, который можно редактировать.

Динамические сущности и атрибуты отображаются в экранах Data Tools.

Аннотация @ExcludeFromAi на уровне кода скрывает сущность или атрибут от инструментов Data Load. В отличие от include- и exclude-свойств jmix.aitools.dataload.*, аннотацию нельзя переопределить при развёртывании.

Новые чаты в UI получают заголовки автоматически. По умолчанию заголовком становится первое сообщение пользователя. В свойстве jmix.aitools.ui.conversation-title-mode можно выбрать короткий заголовок, сгенерированный моделью, или заголовок по умолчанию.

Можно задавать уровень истории процесса (History level) вместе с другими свойствами процесса. Выбранный уровень переопределяет уровень истории движка процессов.

Можно задавать атрибуты flowable:exclusive, flowable:asyncLeave и flowable:asyncLeaveExclusive для задач, встроенных подпроцессов, элементов call activity, шлюзов и большинства событий. Для пользовательских задач, шлюзов и событий теперь доступен и атрибут flowable:async. См. раздел Asynchronous Execution Properties.

Можно добавлять в процессы события эскалации, задавать их свойства и управлять определениями эскалаций (Escalation definitions) в свойствах процесса.

Бэнд отчёта теперь может быть потоковым: его строки читаются из курсора базы данных и записываются в документ XLSX по одной, а не загружаются в память. Чтобы сделать бэнд потоковым, установите для бэнда флажок Streaming на экране деталей отчёта или задайте streaming = true в аннотации @BandDef.

Новый тип набора данных AI-generated JPQL позволяет описать данные бэнда на естественном языке. На экране деталей отчёта LLM генерирует по промпту JPQL-запрос, который хранится в определении отчёта. При запуске отчёта сохранённый запрос выполняется через DataManager с учётом разрешений текущего пользователя на доступ к данным.

Новый экран Email connection заменяет экран OAuth2 token. Он подключает почтовый ящик через Authorization Code Flow или, для Microsoft, через Device Code Flow и сохраняет refresh-токен. Экран также показывает параметры подключения и проверяет подключение к почтовому серверу.

Новое свойство jmix.email.oauth2.redirect-uri задаёт redirect URI для Authorization Code Flow, например, если приложение работает за обратным прокси.

Дополнение само задаёт механизм аутентификации XOAUTH2, поэтому добавлять его в spring.mail.properties.* не нужно.

Экраны чтения можно создавать в Studio с помощью шаблонов Entity read view и DTO entity read view мастера создания экранов.

Экраны чтения можно открывать с помощью бинов ViewNavigators и DialogWindows, а также бина ViewBuilders дополнения Tabbed Application Mode.

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

Аннотация @ReadViewTemplate генерирует экран чтения для сущности во время выполнения. Дополнение Dynamic Model генерирует экраны чтения для динамических сущностей, в которых объявлен экран с type: read.

integerSlider и decimalSlider выбирают значение типа Integer или Double. Как и другие поля, их можно связать с атрибутом сущности и проверять валидаторами.

integerRangeSlider и decimalRangeSlider выбирают диапазон значений, например для фильтрации данных.

Компонент image больше не может содержать другие компоненты. У JmixImage больше нет методов setText()/getText(), setWhiteSpace(), setEnabled()/isEnabled(), add() и remove(). В XML атрибуты enabled, text и whiteSpace, а также вложенные компоненты image игнорируются.

Удалён защищённый метод JmixMenuBarRootItem.updateClassName().

InMemoryUploadHandler и FileTemporaryStorageUploadHandler теперь наследуются от AbstractUploadHandler из Vaadin вместо TransferProgressAwareHandler. FileTemporaryStorageUploadHandler удаляет временный файл, если загрузка завершилась ошибкой или была отклонена, а его метод getFileInfo() возвращает null, пока текущая загрузка не создаст файл.

В дополнении Tabbed Application Mode конфигурация @Push оболочки приложения (app shell) применяется до вызова слушателей UIInitListener, поэтому слушатель может её переопределить.

Anchor.setHref() и IFrame.setSrc(), а также XML-атрибуты href и src компонентов anchor и iframe выбрасывают IllegalArgumentException для схемы URL, которую Vaadin не считает безопасной, например javascript:. Добавьте схему в параметр конфигурации Vaadin safeUrlSchemes или используйте в коде setUnsafeHref() и setUnsafeSrc().

addThemeName("") выбрасывает IllegalArgumentException.

Методы expand(), collapse(), expandRecursively() и collapseRecursively() компонента TreeGrid теперь принимают параметры Collection<? extends T> и Stream<? extends T>. Обновите сигнатуры этих методов, если вы переопределяете их в подклассе TreeDataGrid.

Многие константы VaadinIcon и соответствующие им константы JmixFontIcon объявлены устаревшими. Метод setRole() класса JmixSideDialog объявлен устаревшим, вместо него используйте setAriaRole(). Метод withOverlayRole() интерфейса Dialogs.SideDialogBuilder объявлен устаревшим, вместо него используйте withAriaRole().

Строки, возвращаемые JpqlExecutionResult.getRows() и EntityDataLoadResult.getRows(), теперь содержат null для колонки, у которой нет значения (см. #5598). Раньше такая колонка содержала пустую строку. Строки, которые инструменты возвращают модели, также содержат null вместо пустой строки. Сигнатуры методов не изменились, поэтому компилятор не покажет места, которые нужно исправить. Проверяйте значения на null при чтении строк:

EntityDataLoadResult result = aiDataLoadService.loadData("customers with their email");
for (Map<String, Object> row : result.getRows()) {
    Object email = row.get("email");
    String text = email != null ? email.toString() : ""; // email может быть null
}

EntityDataLoadResult.getQuery() теперь возвращает запрос, который был фактически выполнен или не прошёл валидацию (см. #5749). Если сгенерированный запрос был исправлен, метод возвращает исправленный запрос, а его объяснение, предупреждения, maxResults и firstResult берутся из результата исправления. Исходный запрос, сгенерированный LLM, получить из результата нельзя.

В интерфейсе AiChatMessageService появился новый метод loadLatestMessages() (см. #5649). Если у вас есть собственная реализация этого интерфейса, реализуйте этот метод. Хаб чатов теперь сортирует и группирует беседы по времени последнего сообщения, а не по времени создания.

Заголовком нового чата теперь становится первое сообщение пользователя (см. #5648). Раньше у чата оставался заголовок New AI Conversation. Если ваш код задаёт чату собственный заголовок до первого сообщения, первое сообщение заменит этот заголовок. Чтобы сохранить свой заголовок, вызовите setTitleMode(AiConversationTitleMode.NONE) у AiChatFragment, который показывает этот чат. Чтобы вернуть прежнее поведение во всём приложении, установите для свойства jmix.aitools.ui.conversation-title-mode значение NONE.

В теме по умолчанию используются новая цветовая палитра и новые отступы. Легенда расположена внизу по центру, а заголовок — вверху по центру. Чтобы получить вид, близкий к предыдущей версии, задайте colorPalette="#5470c6, #91cc75, #fac858, #ee6666, #73c0de, #3ba272, #fc8452, #9a60b4, #ea7ccc" для charts:chart, top="0" для charts:legend и left="0" top="0" для charts:title. Проверьте диаграммы, у которых есть компоненты вверху или внизу, например слайдер dataZoom: они могут перекрывать заголовок или легенду.

Подписи и названия осей теперь остаются внутри диаграммы, а названия осей сдвигаются так, чтобы не перекрывать подписи осей. Чтобы вернуть прежнее поведение, задайте outerBoundsMode="NONE" для charts:gridItem или nameMoveOverlap="false" для оси.

Стили форматированного текста (rich text) наследуют настройки шрифта и тени текста обычной подписи. Чтобы вернуть прежнее поведение, добавьте "richInheritPlainLabel": false в nativeJson.

Фигуры bar, pictorialBar, candlestick и boxplot больше не выходят за пределы сетки. Чтобы вернуть прежнее поведение, задайте containShape="false" для оси.

Второй аргумент функции valueFormatter всплывающей подсказки теперь является индексом в исходных данных серии, а не индексом после фильтрации dataZoom. Обновите JavaScript-функции, которые его используют.

Grid.containLabel объявлен устаревшим. Вместо него используйте outerBoundsMode="SAME" вместе с outerBoundsContain="AXIS_LABEL". Когда containLabel включён, параметры outerBounds* игнорируются.

Экран OAuth2 token заменён новым экраном подключения, а его идентификатор изменён с email_tokenView на email_connectionView (см. #5546). Старый маршрут email/token по-прежнему работает. Замените старый идентификатор экрана:

Дополнение больше не определяет бин mailSendTaskExecutor (см. #5703). Раньше Vaadin мог использовать этот бин для своей асинхронной работы, а приложение не запускалось, если в нём был другой бин TaskExecutor. Теперь:

Если аутентификация OAuth2 включена, дополнение строже проверяет конфигурацию (см. #5539):

Источник с featureModifyEnabled="true" больше не показывает действие Delete по умолчанию. Задайте featureDeleteEnabled="true" для источника или установите свойство приложения jmix.maps.ui.feature-modify-includes-delete в true, чтобы сохранить прежнее поведение для всех источников, в которых не задан featureDeleteEnabled.

SourceFeatureDeleteEvent и addSourceFeatureDeleteListener() перенесены из HasFeatureModify в HasFeatureDelete. Замените в своём коде HasFeatureModify.SourceFeatureDeleteEvent на HasFeatureDelete.SourceFeatureDeleteEvent.

OidcAutoConfiguration.DefaulOidcVaadinWebSecurity → DefaultOidcVaadinWebSecurity

SamlAutoConfiguration.DefaulSamlVaadinWebSecurity → DefaultSamlVaadinWebSecurity

Бин claimsRoleMapper в SamlAutoConfiguration → samlAssertionRolesMapper

Класс io.jmix.reports.yarg.loaders.impl.GroovyDataLoader. Для типа загрузчика groovy дополнение использует JmixGroovyDataLoader. В отличие от удалённого класса, он проверяет свойства jmix.core.unsafe-runtime-features-enabled и jmix.reports.groovy-enabled.

Классы InitializationException и ReportingXmlException из пакета io.jmix.reports.yarg.exception.

Методы update() и batch() класса io.jmix.reports.yarg.util.db.QueryRunner. Вместо них используйте Spring JdbcTemplate или JDBC.

Методы commitAndClose(), commitAndCloseQuietly(), rollback(), rollbackAndClose(), rollbackAndCloseQuietly(), loadDriver(), printStackTrace() и printWarnings() класса io.jmix.reports.yarg.util.db.DbUtils.

Метод UnoConverter.createAny(Object). Вместо него используйте new Any(new Type(XCell.class), value).

Поля AbstractFormatter.SIMPLE_ALIAS_REGEXP и DataExtractorImpl.EMPTY_MAP.

Код, который использует специфичные для Xalan возможности XSLT, может перестать работать.

Обработка XML, который превышает ограничения обработки JDK, может завершаться ошибкой.

В Java 21 валидация StAXSource с пустой секцией CDATA завершается ошибкой из-за бага JDK-8349516. Например, BPM не может развернуть такой DMN-файл (см. #5778).

isLoaded() возвращает false для всех атрибутов, кроме идентификатора и атрибутов, установленных после создания.

isLoadedSafe() возвращает YES или NO и не вызывает геттеры.

isLoadedWithFetchPlan() возвращает false для фетч-плана, который содержит другие атрибуты.

getCurrentFetchPlan() возвращает фетч-план с идентификатором и атрибутами, установленными после создания.

Ссылка сериализуется (в REST, в переменных процессов BPM и т.д.) только со своим идентификатором и установленными в ней атрибутами.

Ссылка не получает значения по умолчанию, которые присваиваются при создании в методах @PostConstruct или в инициализаторах полей.

DataContext.merge() ссылки в контекст, в котором уже есть загруженный экземпляр, не заменяет загруженные значения на null.