Чтобы обновить систему:

1.Откройте среду разработки и убедитесь, что все изменения отправлены на Git-сервер. Разработанные вами решения останутся на Git-сервере и не затрутся во время обновления среды разработки.

ВАЖНО. После проверки отправки изменений на Git-сервер закройте среду разработки. Если среду разработки оставить открытой, то при обновлении возникнут ошибки.

2.Остановите и удалите все сервисы. Для этого перейдите в папку с Directum Launcher, запустите командную строку и выполните команду:

do all down

ВАЖНО. Ограничение доступа необходимо для предотвращения ошибок, которые могут возникать из-за блокировки БД пользователями или сервисами. Если во время обновления сотрудники продолжают работать в системе, внесенные изменения могут быть потеряны.

3.Архив с новой версией Directum Launcher скопируйте с заменой файла в корень папки с предыдущей версией Directum Launcher. Архив распаковывать не нужно. Также в корень папки скопируйте архивы:

•Platform.zip – платформа, включающая веб-сервер и сервисы Directum RX;

•WebHelp.zip – справка и слайдер;

•DevelopmentStudio.zip – среда разработки;

•Redist.zip – дополнительные компоненты, необходимые для установки серверной части и среды разработки.

4.От имени администратора запустите файл DirectumLauncher.exe. Откроется командная строка, в ней запустится сервис развертывания, в браузере откроется страница с параметрами установки и обновления. До окончания установки не закрывайте окно командной строки.

Страницу можно открыть вручную по ссылке http://127.0.0.1:5000/, например, если случайно закрыли браузер или он не настроен по умолчанию.

5.Убедитесь, что установлен переключатель Обновление:

6.Проверьте, что поля заполнены верно. Подробнее см. инструкцию по установке среды разработки.

ПРИМЕЧАНИЕ. Если для соединения с базой данных используется Windows-аутентификация, то в конфигураторе в секции Агент управления сервисами Directum RX (ServiceRunner) проверьте, что параметры WINDOWS_USERNAME и WINDOWS_PASSWORD заполнены верно. Подробнее см. руководство администратора, раздел «Конфигурирование настроек».

7.Для обновления справки убедитесь, что установлен флажок Справка о системе. Флажок можно снять, например, если система обновляется для тестирования и нужно сэкономить место на диске.

8.Ознакомьтесь с текстом лицензионного соглашения и установите флажок Я принимаю условия лицензионного соглашения.

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

10.Дождитесь окончания обновления. На странице выводятся этапы обновления. В раскрывающейся области с названием этапа отображаются сообщения из лог-файла DirectumLauncher\log\current.log.

Если при выполнении этапа возникает ошибка, с помощью сообщения из лог-файла проанализируйте и устраните ее, затем нажмите на кнопку Повторить.

примечание. Ошибка с кодом 503 при проверке работоспособности сервисов означает, что они не успели запуститься. В этом случае нажмите на кнопку Повторить.

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

Когда обновление завершится, на странице появится ссылка для входа в веб-клиент.

11.После обновления настройте систему и адаптируйте свою разработку.

Настройка системы и адаптация разработки

1.Запустите среду разработки.

2.Откройте список изменений. Если в списке появились изменения, зафиксируйте их и отправьте на Git-сервер.

3.Импортируйте пакет разработки с базовым решением из архива с прикладной разработкой:

DirectumRX.zip\DirectumRXbase.dat

4.Учтите в своей разработке изменения базового решения Directum RX.

5.Если помимо стандартного решения Directum RX вы используете другие базовые решения, импортируйте пакеты с обновленными решениями, полученные от поставщика.

6.С версии 4.9 появилось версионирование функций инициализации. Если оно используется в системе и в среде разработки были переопределены или добавлены функции инициализации базовых модулей, проверьте совместимость заказной разработки и перенесите свой код в функцию инициализации соответствующей версии. Затем вызовите ее в событии Initializing().

7.С версии Directum RX 4.11:

•прекращается поддержка устаревшей утилиты DeploymentTool, поэтому после обновления системы утилиту можно удалить. Для этого последовательно выполните действия:

1.из конфигурационного файла config.yml удалите секцию DeploymentToolUI вручную или с помощью команды:

do dt_ui uninstall

2.удалите компонент:

do components delete deploymenttoolui

3.из папки с Directum Launcher удалите архив DeploymentTool.zip.

•изменился механизм преобразования документов в PDF с добавлением отметок. Чтобы сохранить совместимость заказной разработки и включить устаревшую реализацию, в таблице Sungero_Docflow_Params в параметре UseObsoletePdfConversion укажите значение True. По умолчанию значение False;

•изменился механизм получения регистрационного номера договорных документов. Чтобы сохранить совместимость заказной разработки и включить устаревшую реализацию, в таблице Sungero_Docflow_Params в параметре UseObsoleteRegNumberGeneration укажите значение True. По умолчанию значение False.

8.С версии Directum RX 4.12:

•в веб-клиенте можно настроить отображение этапов процессов в задачах, заданиях и уведомлениях. Проверьте, что по умолчанию для ваших процессов отображаются только значимые этапы: согласование, регистрация, подписание и т.д. Остальные можно скрыть. Для этого в среде разработки откройте параметры блока и в выпадающем списке *Отображать в этапах процесса выберите значение Не отображать;

•появился редактор отметок. Если в разработке используются собственные отметки, рекомендуется переписать их на язык разметки HTML5, чтобы они корректно отображались в редакторе;

•рекомендуется включить режим совместимости, если в базовом решении перекрыта логика выдачи прав на проектные документы. Для этого адаптируйте логику перекрытий на новый механизм. Затем в таблице базы данных Sungero_Docflow_Params в параметре UseObsoleteGrantAccessRightsToProjectDocuments установите значение True;

•доработан механизм прав доступа: больше не используется способ авторизации Без проверки прав доступа, а также теперь можно задать уровень доступа при программной работе со справочником. Если у вас разработаны свои справочники, то после обновления рекомендуется пересмотреть доступ к ним. Если пользователи не работают со справочником, в нем хранится конфиденциальная информация или настройки системы, то необходимо забрать права на просмотр для всех пользователей и выдать доступ при программной работе на чтение или полный. Подробнее см. в разделе «Доступ при программной работе со справочниками».

9.Опубликуйте решения. Для этого в окне публикации для базовых и разработанных вами решений измените серое положение ползунка на синее и нажмите на кнопку Опубликовать:

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

10.Запустите инициализацию в среде разработки. Подробнее об импорте пакета разработки, сборке, публикации и инициализации решений см. в руководстве разработчика в разделах «Импорт разработки», «Сборка решений», «Публикация решений», «Создание функций инициализации».

11.Примените настройки бизнес-процессов и интерфейса. Для этого на панели инструментов нажмите на кнопку Применить настройки на сервер. Подробнее см. в руководстве разработчика, раздел «Создание и публикация настроек по умолчанию».

© Компания Directum, 2025