Описание файла backend.properties
Файл backend.properties содержит перечень конфигурационных параметров системы:
Одна часть параметров доступна для просмотра и редактирования через интерфейс системы - см. описание по ссылке;
Вторая часть параметров не отображается в интерфейсе системы и является скрытой от пользователя - описание некоторых см. ниже.
Файл backend.properties разделен на различные секции, каждая из которых отвечает за определенные функции системы.
Параметры файла, недоступные на UI
Секция Core
#Jobs - часть секции #Jobs содержит конфигурации стандартных операций.
org.unidata.mdm.core.job.datasource.url- url адрес БД;org.unidata.mdm.core.job.datasource.minPoolSize=${CORE_JOB_DATASOURCE_MINPOOLSIZE:3}- кол-во минимальных подключений в пуле (pool - это список подключений к БД, т.е. кол-во токенов для подключения);org.unidata.mdm.core.job.datasource.maxPoolSize=${CORE_JOB_DATASOURCE_MAXPOOLSIZE:10}- кол-во максимальных подключений в пуле.org.unidata.mdm.core.job.datasource.removeAbandonedTimeout=${CORE_JOB_DATASOURCE_REMOVEABANDONEDTIMEOUT:60}- таймаут отключения соединения в секундах (по умолчанию 60).org.unidata.mdm.core.job.datasource.suspectTimeout=${CORE_JOB_DATASOURCE_SUSPECTTIMEOUT:0}- аналогиченremoveAbandonedTimeout, только вместо закрытия соединений, пишет лог о возможном таймауте (по умолчанию 0, не пишет лог).
Параметры, доступные для редактирования через интерфейс (см. описание по ссылке):
org.unidata.mdm.core.job.pool.min.size = 4org.unidata.mdm.core.job.pool.max.size = 24org.unidata.mdm.core.job.queue.size = 100
Секция Core EE
com.universe.mdm.core.group.notification.skip=false- при включении все уведомления об обновлении группы не будут отправляться.
Отключение уведомлений групп влияет на обновление прав доступа пользователя. При включенном параметре изменения в правах ролей системы Universe, назначенных на группы, не дойдут до пользователя, уже вошедшего в систему. Новые права доступа применятся только при повторном входе в систему.
Примечание: При необходимости изменить права роли, назначенной на группу пользователей, необходимо включить отправку уведомлений (значение параметра = false). Затем нужно изменить права роли - в таком случае активные пользователи получат уведомления об изменении прав групп и смогут обновить свои доступы. После обновления прав, если рассылка уведомлений об обновлении групп не требуется, можно снова их отключить (значение параметра = true).
Секция Ldap integration
com.universe.mdm.ldap.integration.ldap.full.name.source=${LDAP_INTEGRATION_LDAP_FULL_NAME_FORMAT_SOURCE:sgi}- задает источник для чтения полного имени, указывается для всех ldap-соединений. Допустимые значенияdisplayName- чтение из атрибута displayName;sgi- чтение из атрибутов sn, given_name, initials (текущее поведение). Значение по умолчанию =sgi.
Секция Bulk modify assets
Параметры пакетной операции модификации записей:
com.universe.dg.bulk.modify.assets.property.fails.report.limit=${DG_MODIFY_ASSETS_FAILS_REPORT_LIMIT:1000}- ограничение на количество ошибок в детализации уведомления о завершении работы операции (по умолчанию 1000);com.universe.dg.bulk.modify.assets.thread.count=${DG_MODIFY_ASSETS_THREAD_COUNT:4}- количество потоков (по умолчанию 4);com.universe.dg.bulk.modify.assets.block.size=${DG_MODIFY_ASSETS_BLOCK_SIZE:500}- размер блока модифицируемых активов (по умолчанию 500).
Секция Data Governance > Transformation model
org.unidata.dg.meta.import.transformation.model=${IMPORT_TRANSFORMATION_MODEL:true}- параметр регулирует миграцию модели трансформации при миграции модели.
Параметр срабатывает только один раз. Если при старте системы параметр указан как true, то в системе появится модель трансформации, в противном случае - не появится. При дальнейшем изменении параметр не будет оказывать влияния на миграцию.
Секция настройки прав доступа
Параметр org.unidata.mdm.core.secured.property.groups предназначен для дополнительной настройки ресурсов безопасности для групп параметров системы. Список групп передается через запятую. Влияет на Системные права доступа.
Пример:
org.unidata.mdm.core.secured.property.groups=com.unidata.dg.bulk.export.assets.xlsx.group.key, com.unidata.dg.dq.template.properties.group
При отсутствии права на группу пользователю недоступен просмотр и редактирование свойств этой группы. При импорте и экспорте недоступные параметры игнорируются. Исключением являются параметры, необходимые для работы UI (requiredForUI). Такие параметры доступны через REST API независимо от настройки прав.
Список кодов групп:
com.unidata.dg.bulk.export.assets.xlsx.group.key -> Пакетная операция экспорта активов
com.unidata.dg.dq.template.properties.group -> Настройки импорта шаблонов проверок DQ
com.unidata.mdm.bulk.export.properties.group -> Настройки экспорта в XLSX
com.unidata.mdm.ee.guest.mode.group -> Параметры гостевого режима
com.unidata.mdm.license.group -> Настройки лицензии
com.unidata.mdm.workflow.core.properties.group -> Настройки бизнес-процессов
com.universe.dg.data.labeling.group.properties -> Настройки разметки данных
com.universe.dg.data.versioning.properties.group -> Настройки версионирования
com.universe.dg.dis.integration.properties.group -> Настройки интеграции с DIS
com.universe.dg.discovery.client.properties.group -> Настройки клиента Discovery
com.universe.dg.dq.checks.group.properties -> Настройки проверок DQ
com.universe.mdm.core.group.audit.ttl.policy -> Фоновая операция очистки данных журнала аудита системы
com.universe.mdm.core.group.notification.policy -> Параметры групп пользователей
com.universe.mdm.job.export.audit.group -> Операция выгрузки аудита
com.universe.mdm.ldap.integration.properties.group -> Настройки модуля интеграции LDAP
com.universe.mdm.sso.kerberos.properties.group -> Настройки модуля SSO
org.unidata.dg.data.index.group -> Настройки индексирования данных
org.unidata.dg.data.information.system.group -> Настройка информационных систем
org.unidata.dg.data.job.calculate.asset.popularity.group -> Задача "Обновление популярности активов"
org.unidata.dg.data.job.clean.asset.draft.group -> Удаление неиспользуемых черновиков записей
org.unidata.dg.data.scanner.group.properties -> Сканеры
org.unidata.dg.data.xlsx.import.group -> Импорт XLSX-файла
org.unidata.mdm.core.async.task.executor.group -> Исполнение асинхронных задач
org.unidata.mdm.core.fields.cache.group -> Свойства системного кэша полей
org.unidata.mdm.core.group.audit -> Настройки аудита системы
org.unidata.mdm.core.group.email -> Почтовые настройки
org.unidata.mdm.core.group.index -> Индексы
org.unidata.mdm.core.group.job -> Конфигурация стандартных операций
org.unidata.mdm.core.group.model.service -> Общие свойства сервиса моделей
org.unidata.mdm.core.group.password.policy -> Настройки хранения паролей
org.unidata.mdm.core.group.security -> Параметры безопасности приложения
org.unidata.mdm.core.group.system.jobs -> Параметры системных операций модуля Core
org.unidata.mdm.core.upload.group -> Настройки загрузки файлов
org.unidata.mdm.data.data.group -> Настройки хранилища данных
org.unidata.mdm.data.index.group -> Настройки индексирования данных
org.unidata.mdm.data.indexing.group -> Настройки индексирования модели данных
org.unidata.mdm.draft.group.system.jobs -> Служебные задачи модуля черновиков
org.unidata.mdm.meta.admin.source.system.group -> Настройки системного источника данных
org.unidata.mdm.rest.system.properties.group -> Системные свойства REST
org.unidata.mdm.search.fuzziness.group -> Настройки нечеткого поиска
org.unidata.mdm.search.main.group -> Настройки поиска
org.unidata.mdm.search.score.group -> Настройки скоринга при поиске
org.unidata.mdm.system.cache.group -> Настройки кэширования
org.unidata.mdm.system.library.group -> Параметры библиотек
org.unidata.mdm.system.messaging.group -> Настройки подсистемы сообщений
org.unidata.mdm.system.system.group -> Системные настройки
org.universe.mdm.marks.group.marks -> Параметры модуля Marks
Кастомные параметры файла
В файле backend.properties могут описываться различные доработки - например, плагины точек расширения.
Отображение параметров:
Кастомные параметры будут отображаться в интерфейсе в разделе "Параметры системы" в том случае, если они определены как ConfigurationProperty.
В этом случае необходимо в метод key() передать отображаемое значение или код локализации, а саму локализацию поместить в файл локализации. Также в метод groupKey() необходимо передать отображаемое значение или код локализации группы параметров, а саму локализацию также поместить в файл локализации.
Скрытие параметров:
Параметры можно не определять как ConfigurationProperty и вставлять через @Value, в таком случае параметры будут скрыты на UI.
Для этого требуется изменить кастомный код библиотеки на логику работы через Spring @Value, а не через ConfigurationProperty.