Чтобы сервис обрабатывал только сообщения фоновых процессов:

1.В параметре HANDLED_MESSAGE_TYPES установите значение Jobs.

2.Если необходимо обрабатывать конкретные фоновые процессы, то укажите их идентификаторы в параметре JOBS_PROCESSING через разделитель «;». Идентификатор фонового процесса можно найти в карточке соответствующего фонового процесса в модуле «Администрирование», в разделе «Фоновые процессы». Идентификаторы можно записывать полностью либо первые 8 символов. Если список не задан, сервис обрабатывает все доступные фоновые процессы.

3.Если нужно исключить некоторые фоновые процессы из обработки, задайте их идентификаторы в параметре JOBS_EXCLUDED через разделитель «;». Настройка является более приоритетной, чем JOBS_PROCESSING. Таким образом, если идентификатор фонового процесса указан в обоих параметрах, то фоновый процесс не будет обрабатываться.

4.Если после запуска сервиса наблюдается медленная работа фоновых процессов, то можно скорректировать параметр JOBS_PROCESSING_PARALLEL_COUNT. Настройка позволяет изменить количество фоновых процессов, которые сервис может обрабатывать параллельно. Если значение не задано, то количество параллельно обрабатываемых фоновых процессов равно количеству ядер процессора.

Чтобы сервис обрабатывал только сообщения асинхронных обработчиков:

1.Для параметра HANDLED_MESSAGE_TYPES измените значение на AsyncHandlers.

2.Если необходимо запускать конкретные асинхронные обработчики, в параметре ASYNC_HANDLERS_PROCESSING задайте список их идентификаторов через разделитель «;». Идентификаторы можно записывать полностью либо первые 8 символов. Если список не задан, сервис запускает все доступные асинхронные обработчики.

3.Если нужно исключить некоторые асинхронные обработчики из процесса выполнения, задайте их идентификаторы в параметре ASYNC_HANDLERS_EXCLUDED. Идентификаторы можно записывать полностью либо первые 8 символов. Настройка является более приоритетной, чем ASYNC_HANDLERS_PROCESSING через разделитель «;». Таким образом, если идентификатор асинхронного обработчика указан в обоих параметрах, то обработчик выполняться не будет.

4.Если после запуска сервиса наблюдается медленная работа асинхронных обработчиков, скорректируйте параметр ASYNC_HANDLERS_PROCESSING_PARALLEL_COUNT. Настройка позволяет изменить количество потоков, которые сервис может запустить параллельно. По умолчанию количество потоков равно количеству ядер процессора.

Если используются стандартные асинхронные обработчики, то их идентификаторы можно найти в лог-файлах сервиса. Идентификаторы разработанных асинхронных обработчиков можно посмотреть в среде разработки в узле «Асинхронные обработчики» соответствующего модуля.

Предположим, нужно добавить либо исключить асинхронный обработчик AddTimestampToSignature. Чтобы получить его идентификатор:

1.Найдите в лог-файле сообщение о старте асинхронного обработчика по его имени AddTimestampToSignature. Пример найденного сообщения:

{"t":"2023-06-15 07:48:13.385+04:00","pid":"1+331","tr":"cl-172f4ca5-11f08371f7","l":"Info","lg":"AsyncHandlerOperation","span":{"status":"Started","name":"execute","asyncHandler":"AddTimestampToSignature"},…

2.Из найденного сообщения скопируйте идентификатор трассировки, содержащийся в атрибуте tr:

"tr":"cl-172f4ca5-11f08371f7"

3.По скопированному идентификатору найдите запись с сообщением из очереди RabbitMQ. Сообщение содержит атрибуты RabbitMqSubscriber и rabbitMqMessage:

{"t":"2023-06-15 07:48:13.384+04:00","pid":"1+331","tr":"cl-172f4ca5-11f08371f7","l":"Info","lg":"RabbitMqSubscriber","span":{"status":"Started","name":"Handle received message","messageType":"AsyncHandlerMessage","rabbitMqMessage":{"messageId":"11f08371f7", "routingKey":"4fd4f0e6-8a93-4bf7-a258-a4ba947f468f",

4.В атрибуте routingKey первой записи обработки сообщения содержится искомый идентификатор обработчика AddTimestampToSignature:

"routingKey":"4fd4f0e6-8a93-4bf7-a258-a4ba947f468f"

Чтобы сервис обрабатывал только сообщения сервисов хранилищ:

1.Для параметра HANDLED_MESSAGE_TYPES измените значение на DataTransfer.

2.Чтобы снизить нагрузку на сервер, можно сократить количество параллельно выполняемых задач на перемещение содержимого документов между файловыми хранилищами. Для этого задайте количество заданий в параметре DATA_TRANSFER_PARALLEL_COUNT. Если параметр оставить пустым, то по умолчанию количество задач равно числу ядер процессора.

Администратор может изменить настройки автоматического закрытия учетных записей в параметрах:

•CLOSE_INACTIVE_LOGIN_ENABLED – признак того, что фоновый процесс «Закрытие неактивных учетных записей» включен. Снимите флажок (false), чтобы отключить фоновый процесс. По умолчанию флажок установлен (true).

ПРИМЕЧАНИЕ. Если флажок снят (false), а в карточке фонового процесса установлено состояние «Включен», то процесс запускается, но не закрывает учетные записи.

•CLOSE_INACTIVE_LOGIN_AFTER_DAYS – количество дней, после которых закрывается неактивная учетная запись. Значение по умолчанию 90;

•CLOSE_INACTIVE_NONINTERACTIVE_LOGIN_AFTER_DAYS – количество дней, после которых закрывается неактивная учетная запись пользователя, входящего в роль «Неинтерактивные пользователи». Значение по умолчанию 365;

•CLOSE_INACTIVE_LOGIN_EXCLUDED_IDS – список идентификаторов учетных записей, которые всегда будут действующими вне зависимости от указанных выше настроек. Значения задаются через разделитель «;».

Пример настройки:

CLOSE_INACTIVE_LOGIN_ENABLED: 'true'

CLOSE_INACTIVE_LOGIN_AFTER_DAYS: '90'
CLOSE_INACTIVE_NONINTERACTIVE_LOGIN_AFTER_DAYS: '365'
CLOSE_INACTIVE_LOGIN_EXCLUDED_IDS: '1; 2; 66'

Администратор может изменить настройки завершения сеансов работы неактивных пользователей в параметрах:

•LOG_OFF_INACTIVE_USERS_AFTER_MINUTES – время бездействия пользователей. При следующем запуске фонового процесса автоматически завершаются сеансы пользователей, последняя активность которых была больше указанного времени. Значение по умолчанию 120 минут;

•LOG_OFF_INACTIVE_USERS_RESERVED_LICENSE_AFTER_MINUTES – время бездействия пользователей с зарезервированной лицензией. Например, это могут быть руководители, которым нужно в любой момент зайти в систему и подписать документы. При следующем запуске фонового процесса автоматически завершаются сеансы пользователей, последняя активность которых была больше указанного времени. Значение по умолчанию 120 минут;

•LOG_OFF_INACTIVE_USERS_WITH_LOCKS – признак того, что фоновый процесс может завершать сеансы пользователей с блокировками на карточки или открытыми на редактирование документами. Установите флажок (true), чтобы разрешить завершать сеансы несмотря на блокировки. По умолчанию флажок снят (false).

Чтобы сервис обрабатывал несколько типов сообщений, перечислите их через «;» в параметре HANDLED_MESSAGE_TYPES. Если параметр не заполнен, обрабатываются все типы сообщений.

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

После запуска фоновый процесс «Копирование прав доступа» выполняется каждую минуту и обрабатывает порциями по 1 000 объектов, на которые нужно выдать права. Администратор может изменить это значение в параметре COPY_ACCESS_RIGHTS_JOB_BATCH_SIZE сервиса асинхронных событий. Например, увеличить значение, чтобы права копировались быстрее, либо уменьшить, если при копировании создается нагрузка на систему.

С версии Directum RX 4.6 веб-сервер, среда разработки и все микросервисы работают на .NET 6. Совместимость с .NET Core 3.1 сохраняется. Если вы используете сторонние библиотеки, собранные по спецификации .NET Standard 2.0, то их адаптировать не нужно, так как они совместимы и с .NET Core 3.1, и с .NET 6.

Если в вашей разработке используются сторонние компоненты, которые поддерживают работу только с .NET Framework, то оставлена возможность перенастроить сервис Worker на работу под .NET Framework 4.8. Для этого:

1.Перенесите программный код, связанный со сторонним компонентом, в асинхронные обработчики. Это нужно, чтобы код выполнялся под управлением сервиса Worker.

2.В Directum Launcher во встроенном редакторе YAML добавьте секцию SungeroWorkerNetFx:

SungeroWorkerNetFx:

        <<: *base

3.Перенастройте параметры, если необходимо, и удалите секцию SungeroWorker.

Проверка работоспособности сервисов