Свойства приложения

OpenBPM Control — приложение на Spring Boot и Jmix, поэтому настраивается стандартными механизмами Spring Boot. На этой странице собраны свойства, специфичные для OpenBPM Control, и наиболее важные общие свойства. Полный перечень свойств платформы Jmix (jmix.) и подробности по ним — в документации Jmix, свойства Spring Boot (server., spring., logging., management.*) — в документации Spring Boot.

Как задать свойство

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

Способ Пример Где применяется

Внешний файл application.properties

config/application.properties рядом с JAR: server.port=9090

Portable-дистрибутив. Spring Boot автоматически читает файл из каталога ./config/ относительно рабочего каталога.

Переменная окружения

SERVER_PORT=9090

Docker, Kubernetes, systemd. Имя переменной образуется из имени свойства: точки и дефисы заменяются на _, буквы переводятся в верхний регистр (relaxed binding). Например, openbpm.control.features.modification-enabled → OPENBPM_CONTROL_FEATURES_MODIFICATION_ENABLED.

Системное свойство JVM

-Dserver.port=9090

Запуск через java -D…​ -jar, WildFly (standalone.conf).

Аргумент командной строки

--server.port=9090

java -jar openbpm-control.jar --server.port=9090 или ./run.sh --server.port=9090 в portable-дистрибутиве.

После изменения свойств приложение нужно перезапустить.

Сервер

Свойство По умолчанию Назначение

server.port

8081

HTTP-порт приложения.

server.servlet.session.cookie.name

CONTROL_JSESSION

Имя cookie сессии. Имеет смысл изменить, если несколько приложений Jmix работают на одном домене.

jmix.core.available-locales

en,ru

Доступные языки интерфейса.

management.endpoints.web.exposure.include

health,info

Эндпоинты Spring Boot Actuator, доступные по HTTP (/actuator/health, /actuator/info).

База данных

Подробнее о поддерживаемых СУБД — на странице Базы данных.

Свойство По умолчанию Назначение

main.datasource.url

встроенная HSQLDB

JDBC URL базы данных OpenBPM Control.

main.datasource.username

sa

Имя пользователя БД.

main.datasource.password

пусто

Пароль пользователя БД.

main.datasource.driver-class-name

определяется по URL

Класс JDBC-драйвера. Указывать нужно только если он не определяется автоматически.

Пул соединений настраивается свойствами main.datasource.hikari.* (например, main.datasource.hikari.maximum-pool-size) — см. документацию HikariCP.

Подключение к движку BPM

Сами движки добавляются через интерфейс (см. Подключение к движку BPM). Свойства ниже управляют тем, как приложение обращается к REST API движка.

Свойство По умолчанию Назначение

spring.cloud.openfeign.client.config.default.connect-timeout

10000

Таймаут установки соединения с REST API движка, мс.

spring.cloud.openfeign.client.config.default.read-timeout

30000

Таймаут ожидания ответа REST API движка, мс. Увеличьте при работе с большими выборками.

openbpm.control.engine.offset-lifetime-in-millis

10000

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

openbpm.control.engine.oauth2.lock-enabled

false

Блокировка при получении access token для движка с аутентификацией OAuth2: исключает параллельные запросы токена из разных потоков.

openbpm.control.engine.oauth2.max-retries

5

Максимальное число повторных попыток получить access token.

openbpm.control.ui.connection-check.interval-sec

30

Периодичность фоновой проверки доступности выбранного движка из интерфейса, с.

openbpm.control.ui.connection-check.connect-timeout

10000

Таймаут установки соединения при проверке доступности, мс.

openbpm.control.ui.connection-check.read-timeout

10000

Таймаут ожидания ответа при проверке доступности, мс.

openbpm.control.ui.connection-check.max-retries

1

Число повторных попыток при неудачной проверке.

openbpm.control.ui.connection-check.retry-timeout

100

Пауза между повторными попытками, мс.

Интерфейс

Свойство По умолчанию Назначение

openbpm.control.ui.dashboard-load-timeout-sec

300

Таймаут загрузки данных дашборда, с.

openbpm.control.ui.engine-time-load-timeout-sec

300

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

openbpm.control.ui.recent-activity-max-results

500

Максимальное число записей в блоке недавней активности на дашборде.

openbpm.control.ui.recent-activity-days

7

Глубина выборки недавней активности, дней.

Безопасность

Свойство По умолчанию Назначение

openbpm.control.security.login-mode

не задано

Режим входа. Значение oidc включает вход через внешнего провайдера OpenID Connect; при этом требуются свойства spring.security.oauth2.client. и jmix.oidc.. Подробности и пример настройки Keycloak — на странице Single Sign-On (SSO).

ui.login.defaultUsername, ui.login.defaultPassword

не задано

Предзаполнение полей на экране входа. Удобно для демо-стендов; не используйте в производственной среде.

Функции Enterprise

Свойства этого раздела действуют только в редакции OpenBPM Control Enterprise.
Свойство По умолчанию Назначение

openbpm.control.features.modification-enabled

true

Доступность модификации экземпляров процесса в интерфейсе.

openbpm.control.diagnostics.no-worker-threshold-minutes

15

Порог диагностики экземпляра процесса: external task считается «без исполнителя», если ни один воркер не забирал его дольше указанного времени, мин.

openbpm.control.diagnostics.unassigned-threshold-minutes

240

Порог диагностики экземпляра процесса: пользовательская задача считается «зависшей без назначения», если у неё нет исполнителя дольше указанного времени, мин.

AI-ассистент

Свойства этого раздела действуют только в редакции OpenBPM Control Enterprise.

Ассистент использует Spring AI и подключается к любому API, совместимому с OpenAI. Сценарии настройки для portable-дистрибутива и Docker — на странице AI-ассистент.

Свойство По умолчанию Назначение

spring.ai.openai.api-key

пусто

API-ключ провайдера LLM. Пока не задан, ассистент показывает сообщение о том, что не настроен.

spring.ai.openai.base-url

не задано

Базовый URL эндпоинта, совместимого с OpenAI, без суффикса /v1. Необязательно при работе с OpenAI; для локальных моделей укажите адрес вашего сервера, например Ollama.

spring.ai.openai.chat.model

не задано

Имя модели в том виде, в котором его ожидает провайдер. Необязательно: без него используется модель по умолчанию Spring AI.

Логирование

Уровни логирования задаются стандартными свойствами logging.level.<logger>. Наиболее полезные при диагностике:

Свойство По умолчанию Назначение

logging.level.io.openbpm

info

Логи самого приложения OpenBPM Control.

logging.level.org.camunda.community.rest.client.api

не задано

debug включает логирование запросов к REST API движка (вместе с spring.cloud.openfeign.client.config.default.logger-level=BASIC).

logging.level.io.jmix

info

Логи платформы Jmix.

logging.level.eclipselink.logging.sql

info

debug выводит SQL-запросы ORM.