Действия после обновления системы

В НО 26.1, включающем Консоль управления Docsvision 6.2 и выше и другие модули, часть параметров из конфигурационных файлов была перенесена в интерфейс Консоли управления. Консоль управления стала приоритетным способом настройки системы, однако настройки из конфигурационных файлов всё ещё имеют приоритет. Это сделано с целью оставить возможность постепенного перехода к конфигурации исключительно через Консоль управления.

Изменять конфигурационные файлы допустимо только после полного завершения всех действий по обновлению системы, чтобы существующие настройки автоматически перенеслись в интерфейс Консоли управления. После обновления системы рекомендуется привести конфигурационные файлы модулей системы к эталонному виду. Эталонные конфигурационные файлы располагаются по адресу /usr/lib/docsvision/имя-модуля/appsettings.json.dpkg-dist.

После обновления системы выполните следующие действия:
  1. На сервере Docsvision перейдите к каталогу /usr/lib/docsvision/ и откройте каталог любого модуля, например, /usr/lib/docsvision/platform/.

  2. Найдите файл appsettings.json (Configuration.json для Службы фоновых операций) и создайте его резервную копию.

  3. Откройте и сравните текущий (не резервный) конфигурационный файл appsettings.json с эталонным appsettings.json.dpkg-dist при помощи любой утилиты сравнения текстовых файлов.

  4. Удалите параметры, которых больше нет в эталонном файле. Если в appsettings.json отсутствуют параметры из эталонного файла, добавьте их и при необходимости заполните рабочими настройками.

  5. Повторите аналогичные действия для каждого модуля и службы: Web-клиент, Управление процессами, Файловый сервис.

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

    $ sudo systemctl restart dvappserver dvwebclient dvsettings dvconsole dvworkerservice dvworkflow dvfileservice

    Обратите внимание, начиная с определённых версий[1], перечисленные далее системные службы запускаются от имени УЗ Docsvision и не требуют root-привилегий: Web-клиент, Управление процессами, Службы фоновых операций, Сервиса настроек, Консоли управления Docsvision Файлового сервиса, Сервиса полнотекстового индексирования.

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

Перенос загружаемых данных приложений Docsvision

При обновлении БД Docsvision библиотеки карточек Модулей и Приложений будут перезагружены. Если ранее была разработана собственная библиотека карточек, её нужно будет также загрузить:

  • Если библиотека карточек загружалась с помощью CardManager:

    1. Создайте новую папку в каталоге /lib/docsvision/database/. Например, создайте папку MyCarLib.

    2. Скопируйте в созданную папку (/lib/docsvision/database/MyCarLib) файлы библиотеки карточек.

    3. Создайте в данной папке новый файл с названием Install.xml и следующим содержимым:

      <?xml version="1.0" encoding="UTF-8"?>
      <SqlPackage>
          <SqlFile>MyOwnCardLib.xml</SqlFile> (1)
      </SqlPackage>
      1 Вместо MyOwnCardLib.xml укажите собственное название файла со схемой библиотеки карточек.

      Данная библиотека карточек станет доступна для загрузки при обновлении БД Docsvision.

      Если дополнительно было разработано собственное решение, его также потребуется адаптировать согласно инструкции, описанной в руководстве по разработке, "Разработка решений на платформе Docsvision".

Настройка приложения "Управление документами"

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

Настройка прав доступа к файлам

При добавлении файлов или отчета в "Задания УД" и "ГЗ" создаются карточки вида "Файл". Чтобы доступ к таким карточкам работал корректно и только участники заданий могли работать с файлами, необходимо настроить ролевую модель для вида документа "Файл" следующим образом:

Для новых БД, созданных после обновления до Управление документами версии 6.1, сборка 93 и выше, права доступа будут применены автоматически, дополнительных действий не требуется.

Хранимые процедуры dvbo_Operand_FileDocument_TasktreeEmployees и dvbo_Operand_FileReport_TaskEmployee, необходимые для настройки, входят в модуль Базовые объекты версии 6.1, сборка 311 и выше.

  1. Откройте Конструктор ролей.

  2. Выберите вид карточек Документ — Файл.

  3. Создайте роль с названием Участник задания с отчётом.

  4. Измените корневой оператор в значение ИЛИ.

  5. Добавьте условия для роли Участник задания с отчётом:

    • Я — временный заместитель в период неактивности замещаемого, Равно, хранимая процедура dvbo_Operand_FileReport_TaskEmployees.

    • Я, Равно, хранимая процедура dvbo_Operand_FileReport_TaskEmployees.

    • Я — постоянный заместитель, Равно, хранимая процедура dvbo_Operand_FileReport_TaskEmployees.

  6. Создайте роль с названием Участник задания с файлом.

  7. Измените корневой оператор в значение ИЛИ.

  8. Добавьте условия для роли Участник задания с файлом:

    • Я — временный заместитель в период неактивности замещаемого, Равно, хранимая процедура dvbo_Operand_FileDocument_TasktreeEmployees.

    • Я, Равно, хранимая процедура dvbo_Operand_FileDocument_TasktreeEmployees.

    • Я — постоянный заместитель, Равно, хранимая процедура dvbo_Operand_FileDocument_TasktreeEmployees.

  9. Создайте роль с названием Регистратор.

  10. Измените корневой оператор в значение ИЛИ.

  11. Добавьте условия для роли Регистратор:

    • Я — временный заместитель в период неактивности замещаемого, Равно Основная информация.Автор.

    • Я, Равно Основная информация.Автор.

    • Я — постоянный заместитель, Равно Основная информация.Автор.

  12. Для созданных ролей в матрице доступа выдайте все права, которые настроены для роли Все.

  13. Для роли Все в матрице доступа удалите все назначенные права.

  14. Сохраните настройки ролей.

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


1. Точные версии следующие: Web-клиент 6.1 сборки 1110 и выше, Управление процессами версии 6.1, сборка 284 и выше, Службы фоновых операций версии 6.1, сборка 147 и выше, Сервис настроек версии 6.1, сборка 187 и выше, Консоль управления Docsvision версии 6.2, сборка 1057 и выше, Файловый сервис устанавливается вместе с модулем Платформа версии 6.1, сборка 853 и выше, Сервис полнотекстового индексирования устанавливается вместе с модулем Платформа версии 6.1, сборка 853 и выше