На недавнем вебинаре по Jmix BPM мы говорили о событиях в процессе.

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

Если вы думаете, что достаточно поставить флаг async и все волшебным образом образуется, то это не так. Все гораздо сложнее.

Чтобы разобраться в этом вопросе читайте на Хабре новую статью Станислава Макарова
Неблокирующий вызов внешнего сервиса в процессе

#статья

🆕 Видеообзор: Что нового в Jmix 2.5

Дмитрий Кремнев, ведущий разработчик Jmix, вернувшись с нашего митапа, не смог остаться равнодушным к просьбе коммьюнити подготовить отдельное видео по последним обновлениям и планам на будущее!

Специально для тех, кто не смог посетить встречу в Москве, публикуем обзор релиза 2.5 🤘

📌 VK
📌 YOUTUBE

Делитесь обратной связью в чате!

#обновления #jmix25

Продолжаем рассказывать про новое в релизе Jmix 2.5!🎉

Сегодня речь пойдет про REST API и REST DataStore, два аддона, которые работают в паре и дополняют друг друга. В новом релизе их взаимодействие стало еще теснее.

🔸Фетч-планы в REST API и REST DataStore
Теперь вы можете передавать произвольные fetch-планы в виде JSON-объектов в ваши REST API endpoints.

Что это значит для вас? 🤔
✅ Больше не нужно определять все fetch-планы в общих репозиториях.
✅ Используйте встроенные fetch-планы в ваших клиентских экранах и Java-коде!

🔸Новый Capabilities API
Он информирует клиента о функциях, поддерживаемых данным универсальным REST API.

🔸Использование FileStorage с REST DataStore
В REST DataStore  появилась специальная реализация FileStorage, которая работает с файлами, расположенными в хранилище файлов удаленного приложения через REST-эндпойнты /files.

🔸Настраиваемые пути REST-эндпойнтов
Пути универсальных эндпойнтов REST API теперь можно настраивать с помощью свойств приложения.

🔸Сессии в REST API
Дополнение Jmix Sessions предоставляет поддержку сессий, поддерживаемых для REST-запросов с одним и тем же токеном. 

#фича #jmix25

Продолжаем рассказывать про Jmix.2.5📣

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

Гайд по инициализации сущностей🎉

Зачем нужно инициализировать сущности? — Есть много причин.
Например, можно сократить проверки на null, уменьшить ручной ввод, минимизировать ошибки и так далее.

— Но это же очень просто!
Мы же умеем инициализировать переменные в коде.
В чем проблема?

Дело в том, что в Jmix задать начальные значения атрибутов сущностей можно несколькими разными способами, и это по-разному сказывается на конечном результате —поэтому и понадобился специальный гайд.

Итак, сущности можно инициализировать:

🔸 Прямо в описании класса
🔸 С помощью метода @PostConstruct
🔸 Посредством инжекции зависимостей
🔸 По событиям InitEntityEvent, EntitySavingEvent, EntityChangedEvent

На уровне UI💻, причем есть несколько вариантов

🔹 При инициализации экрана
🔹 При обновлении связанных полей
🔹 При сохранении сущности

А когда какой способ рациональнее выбрать, 📚читайте в нашем гайде

#гайд #jmix25

Поваренная книга от Jmix, выпуск 2:
Работа с данными в UI

Вот несколько рецептов для эффективной работы с данными и элементами UI!

1️⃣ Каскадные выпадающие списки
Каскадные выпадающие списки фильтруют элементы на основе предыдущего выбора в иерархии. Например, выбор планеты в первом списке обновляет второй список, показывая ее луны.
📌 Совет: Используйте DataLoadCoordinator, чтобы автоматически перезагружать связанные данные при изменении выбора!

2️⃣ Копирование сущностей
При копировании сущностей в представлениях списка вы можете использовать два подхода:
• Копировать: Создает новый экземпляр и немедленно сохраняет его.
• Копировать и редактировать: Создает новый экземпляр и открывает детальный просмотр сущности для редактирования. Сохраняется только после подтверждения пользователем.
🛠 Совет: Используйте MetadataTools.copy() для поверхностного копирования выбранных сущностей.

3️⃣ Пользовательский фильтр с декларативными условиями
Вы можете реализовать пользовательский фильтр, связав поля ввода с условиями запроса через DataLoadCoordinator. Он автоматически инициирует загрузку данных при событии BeforeShowEvent.
🔍 Совет: Совмещайте с компонентом genericFilter для большей гибкости.

4️⃣ Пользовательский фильтр с модификацией запроса
Изменяйте текст запроса программно, когда изменяется значение поля ввода. Это позволяет реализовать более сложные фильтрации, например, поиск без учета регистра.
🛠 Совет: Метод reload() в контроллере явно инициирует логику фильтрации.

5️⃣ Отложенная загрузка данных
Оптимизируйте пользовательский опыт, откладывая загрузку данных до окончательного выбора. После завершения выбора заказов, данные загружаются через 2 секунды.
⏱ Совет: Используйте фасет таймера для загрузки данных только после завершения выбора пользователя.

6️⃣ Сохранение сущности через пользовательский сервис
Отправляйте сущности в пользовательские сервисы для обработки, обеспечивая изолированную и гибкую работу. Например, обновите статус контракта через сервис, перехватывая стандартные операции сохранения.
💡 Совет: Используйте сервисные бины для обработки изменений статуса и убедитесь, что представление сохраняет только измененные сущности.

7️⃣ Использование представлений базы данных
Используйте только для чтения представления базы данных для отображения агрегированных данных без возможности редактирования. Для редактирования данных используйте связанные сущности через обработчики.
🔧 Совет: Обновляйте таблицу данных после успешного коммита с помощью окна диалога для редактирования.

🔗 Следите за новыми полезными советами!
Первый пост о Cookbook смотри здесь.
#cookbook

Jmix 2.5: Генерация клиента OpenAPI по тегам – что это значит?

При генерации клиентского кода из схемы OpenAPI обычно создается код для всего API, включая все эндпоинты и модели. Однако в Jmix 2.5 теперь можно генерировать клиентский код только для определенных тегов, заданных в OpenAPI.

Как это работает?

1. OpenAPI использует "теги" для группировки API-эндпоинтов. Например, в API для e-commerce можно иметь:
🔹Orders (для работы с заказами)
🔹Customers (для работы с клиентами)
🔹Products (для работы с товарами)

2. С этим новым функционалом вы можете выбрать только нужные теги при генерации клиентского кода. Если вам нужны только заказы, выбираете тег Orders, а остальные игнорируете.

3. Studio автоматически отфильтрует неиспользуемые схемы. Исключаются модели (структуры данных), которые не задействованы в выбранных эндпоинтах, уменьшая объем сгенерированного кода.

Зачем это нужно?

✅ Меньше кода – Нет необходимости разбираться с лишними моделями и эндпоинтами.
✅ Проще поддерживать – Компактный клиентский код удобнее в работе.

Эта возможность помогает интегрироваться с большими API, не перегружая проект лишним кодом.

Смотрите подробнее в гайде Integrating Applications Using OpenAPI

#фича #jmix25

​‼️ Не забудьте зарегистрироваться на вебинар про сокращение затрат при разработке решений на Java!

9 апреля в 16:00 по мск Jmix и Axiom JDK предложат решение, как перестать изобретать "велосипеды" и не сжигать ресурсы при создании проекта.

А еще поговорим про:

🔹 Ситуацию с программным обеспечением на ИТ рынке 2025.
🔹 Вызовы при создании внутренних цифровых активов компании.
🔹 Пути разработки на Java. Подходы к построению архитектуры web-приложения.

🔗 Регистрация по ссылке

Ждем вас!

#мероприятия

🚀 OpenBPM Control – приложение на Jmix

Вы, наверное, слышали, что Haulmont выпускает новый продукт — платформу для автоматизации бизнес-процессов OpenBPM? Если ещё нет, то срочно бегите смотреть на сайте openbpm.ru 🔗

Но сегодня мы хотели сказать о другом: о том, что Jmix идеально приспособлен для разработки самых разнообразных административных панелей ⚙️

С помощью Jmix вы можете быстро создать модель данных и CRUD-экраны для манипулирования вашими сущностями и справочниками.

Затем добавляете бизнес-логику для административных функций, генерите клиента для OpenAPI и управляете любыми вашими серверами.

Вишенкой на торте 🍒 станут отчёты и графики на дашбордах 📊

За примерами далеко ходить не надо: именно так был разработан OpenBPM Control — приложение для администраторов систем BPM с движком Camunda.

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

По своей функциональности OpenBPM Control сопоставим с Camunda Cockpit, но выделяется возможностью подключения нескольких движков и легко кастомизируется благодаря Jmix.

✅ Заметьте, что управление бизнес-процессами — отнюдь не самая простая предметная область! Однако, разработка OpenBPM Control заняла всего пару месяцев, а результат получился отличный!

Кстати, OpenBPM Control — это open source, всё, как мы любим 🧡
Вы можете скачать его из репозитория на GitHub и оценить в работе, если у вас есть сервера Camunda.

#Camunda #кейсы_клиентов

Поваренная книга от Jmix, выпуск 3:
📌 Полезные UI-рецепты

Вот несколько интересных примеров, которые не связаны напрямую с данными приложения, но могут улучшить пользовательский интерфейс!

1️⃣ Копирование текста в буфер обмена
Легко копируйте текст в буфер обмена с помощью асинхронной JavaScript-функции. Поскольку копирование возможно только на стороне клиента, этот метод обеспечивает корректную работу.

2️⃣ Кастомная форма логина
Настройте внешний вид страницы входа с помощью CSS и добавьте фоновое изображение.
📌 Совет: Храните изображение в папке темы приложения, чтобы оно было доступно на клиенте.

3️⃣ Отображение статического PDF в IFrame
Выводите статические PDF-файлы с помощью компонента IFrame.
📂 Совет: Храните файлы в папке META-INF/resources и настройте директиву безопасности frame-ancestors для корректного доступа.

4️⃣ Загрузка PDF через REST в IFrame
Выводите PDF-файлы, хранящиеся в виде FileRef, с помощью REST API.
🔧 Совет: Используйте кастомный контроллер (CustomFileDownloadController.java) и настройте фильтр безопасности (CustomRestSecurityConfiguration.java) для безопасного доступа к файлам.

5️⃣ Мастер (Wizard) для пошагового ввода данных
Реализуйте мастер для ввода данных!

📌 Пример: Мастер для создания записи о сотруднике с этапами:
✅ Ввод основной информации
✅ Добавление адреса
✅ Проверка введенных данных

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

🛠 Эти небольшие, но мощные улучшения значительно повысят удобство работы с приложением! Следите за новыми полезными советами.

#cookbook #гайд

Jmix 2.5: Расширенный экран списка задач BPM

В Jmix BPM кроме стандартного экрана задач, можно добавить расширенный экран, который стал более дружественным к пользователю.

Но главное его достоинство не в этом. Этот экран вам будет проще дорабатывать.

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

Кстати, специально для тех, кто в своих проектах изрядно доработал стандартный список задач, мы оставили старый экран на прежнем месте и в том же виде, чтобы не было проблем с совместимостью.

А для новых проектов сразу берите новый экран!

Лайфхак: можно создать сколько угодно таких экранов в проекте!
— Зачем это нужно? Например, чтобы сделать разные экраны для разных категорий пользователей и типов задач.

Так вы создаёте не просто экран, а UX, который нужен вашим пользователям.

#jmix25 #фича

⚙️ Мастер-класс по UI: Быстрое создание пользовательского приложения на Jmix

Дмитрий Кремнев успевает всё! И разработкой заниматься, и наш новый худи выгуливать, и мастер-класс приготовить по Jmix UI 🌪

23 апреля в 16:00 по мск Дима вместе с Антоном Решановым, Руководителем продаж, продолжит тему про пользовательский интерфейс и вместе с вами создаст пример экрана пользователя в социальной сети. Напомним, что в прошлом году мы разобрали теоретическую часть Jmix UI.
📌 Рекомендуем ознакомиться с прошлым вебинаром.

В этот раз вы научитесь реализовывать пользовательский CSS и создавать приложения со специфичным CSS. Дима поделится лучшими практиками и ответит на любые вопросы!

🔗 Регистрация на вебинар тут.

Всем жмых! 👨‍💻

#мероприятия