Настройка Службы фоновых операций

Служба фоновых операций — дополнительный сервис Docsvision для фоновой обработки задач, формируемых компонентами системы Docsvision.

Чтобы получить подробную информацию об устройстве Службы фоновых операций, обратитесь к документации модуля Docsvision Служба фоновых операций, раздел "Общие сведения о модуле".

Консоль управления Docsvision позволяет управлять фоновыми операциями Службы фоновых операций: регистрировать новые фоновые операции и выбирать их конфигурацию для обработки задач.

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

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

Вкладка "Служба фоновых операций"

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

Вкладка "Служба фоновых операций"
Рисунок 1. Вкладка "Служба фоновых операций"

На вкладке отображаются узлы Службы фоновых операций. Набор узлов определяется по зарегистрированным узлам в Сервис настроек. Узлы добавляются автоматически при установке Службы фоновых операций.

Блок настроек узла и процессов
Рисунок 2. Блок настроек узла и процессов

После установки модулей Docsvision (например, модуля Базовые объекты) в Сервис настроек Консоли автоматически появляются процессы Службы фоновых операций. Каждый узел может обрабатывать процессы с определённым типом конфигурации. Такие процессы отображаются в списке. Тип конфигурации можно выбрать только из тех расширений, с которыми работает данный узел Службы фоновых операций.

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

  2. Правее кнопки сворачивания/разворачивания располагается название узла и индикатор его текущего состояния. Состояние узла обновляется при обновлении страницы или при нажатии на кнопку обновления в блоке кнопок (5).

    Узел может иметь два состояния:

    • Доступен — индикатор зелёный.

    • Недоступен — индикатор красный.

  3. Название процесса. Название задаётся при его создании при помощи кнопки (4).

  4. Кнопка создания нового процесса. При нажатии на кнопку потребуется ввести Имя процесса и выбрать Тип конфигурации.

    Заполнение данных о процессе
    Рисунок 3. Заполнение данных о процессе
    Имя процесса

    Произвольное имя процесса для его идентификации.

    Тип конфигурации

    Тип конфигурации определяет список задач, выполняемых процессом, и метод их выполнения.

  5. Блок кнопок справа от заголовка узла.

    Кнопки позволяют:

    • Переименовать экземпляр службы — переименовать экземпляр службы. Имя экземпляра службы формируется в формате имя-службы : имя-машины. Уникальное имя службы задаётся во всплывающем меню при нажатии на кнопку карандаша. Имя машины формируется автоматически, исходя из имени машины, на которой установлена Служба фоновых операций. Если имя узла и имя машины совпадают, отображается только имя машины без двоеточия.

    • Перезапустить все процессы — нажатие на кнопку перезапускает все процессы Службы фоновых операций.

    • Урна — кнопка удаляет экземпляр службы. При нажатии возникнет диалог подтверждения удаления с кнопками Удалить и Отмена.

  6. Блок кнопок напротив заголовка процесса:

    • Урна — кнопка удаляет экземпляр процесса. При нажатии возникнет диалог подтверждения удаления с кнопками Удалить и Отмена.

    • Перезапустить процесс — перезапускает выбранный процесс.

Настройки процесса

Настройки процесса
Рисунок 4. Настройки процесса

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

    Имя процесса

    Произвольное имя процесса для его идентификации.

    Тип конфигурации

    Тип конфигурации определяет список задач, выполняемых процессом, и метод их выполнения.

    • Базовые объекты / Back office — конфигурация для обработки заданий и групп заданий.

    • Обслуживание ЭП / Signature maintenance (сервис перештамповки) — конфигурация для обработки электронных подписей: вычисление типа, статуса и времени окончания срока действия подписи.

    • Расширение для WorkerService — расширение для модуля Служба фоновых операций, название может отличаться в зависимости от заданного во время разработки расширения. Представляет собой отдельный конфигурационный файл в формате .json, помещаемый в папку расширений Консоли управления ManagementConsole  SampleExtensions.

      Для корректной работы службы фоновых операций с использованием сервиса перештамповки подписей необходимо использовать машину, имеющую как минимум два процессора.
    Соединение Docsvision

    Выберите настроенное подключение Docsvision из списка. Настроить подключение можно на вкладке Соединения.

    Набор доступных типов соединений зависит от выбранного типа конфигурации и заполняется значением по умолчанию с вкладки Соединения. При желании соединения можно изменить. Соответствие типов конфигураций и типов соединений составляется автоматически и не может быть отредактировано из Консоли.

    Если в настройках узла Службы фоновых операций не указано соединение, при обработке сообщения, требующего соединение данного типа, возникнет ошибка No connection factory for type.. (please check worker process configuration).
    Соединение Почтовый сервер

    Выберите из списка настроенное подключение к почтовому серверу. Настроить подключение можно на вкладке Соединения.

    Таймаут

    Время ожидания выгрузки рабочего процесса. Если значение не указано (0), используется значение по умолчанию: 60 секунд.

    Отключено

    Установите флаг, чтобы отключить обработку заданий данной фоновой операцией. Снимите флаг, чтобы снова включить обработку. Если такой флаг активен, процесс не запускается.

    Использовать x86

    Установите флаг, чтобы переключить обработку заданий на версию фоновой операции с указанной разрядностью. Когда флаг снят, используется разрядность x64.

    Дней до окончания действия сертификата

    Только для типа конфигурации Обслуживание ЭП. Конечный срок, после которого ЭП перестанет быть действительной (по умолчанию 60 дней).

    Значение поля Дней до окончания действия сертификата не может быть больше срока действия сертификата. В противном случае возможны ошибки Message: SignaturePeriodicComponent unable verify and enhance signature в журнале службы фоновых операций.
    Интервал запросов

    Только для типа конфигурации Обслуживание ЭП. Периодичность работы компонента по умолчанию 300 сек.

  2. Нажмите Сохранить, чтобы добавить созданный процесс на страницу.

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

Изменить процесс

Чтобы изменить процесс:

  1. Наведите курсор на поле, которое хотите изменить, выберите новое значение из списка или установите флаг.

    Процесс с несохранёнными изменениями будет отмечен красной пунктирной рамкой.

    Изменение настроек процесса
    Рисунок 5. Изменение настроек процесса

  2. Нажмите кнопку Применить, чтобы сохранить внесённые изменения.

  3. В появившемся диалоговом окне подтвердите применение настроек.

  4. Процесс будет перезапущен, необходимо перезапустить Службу фоновых операций вручную.

Удалить процесс

Чтобы удалить процесс:

  1. Нажмите на кнопку Чёрная урна.

  2. В появившемся диалоге подтвердите удаление.

    Подтвердите удаление
    Рисунок 6. Подтвердите удаление

  3. Процесс будет удалён из экземпляра Службы фоновых операций.