Важно. С версии Directum RX 4.5 веб-сервер и сервисы системы выделены из Directum Launcher в компонент платформы и поставляются в виде архива Platform.zip.

В версии 4.7 идентификаторы всех типов объектов переведены с типа int на long. Поэтому после обновления адаптируйте разработку под работу с большими ИД.

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

1.Пользователю, от имени которого выполняется подключение к MongoDB, выдайте права доступа к базам данных Sungero_dist_cache, Sungero_StorageService, sungero_ip_blocking, Sungero_HealthCheck. Для этого запустите Mongo Shell и выполните команды:

use admin

db.grantRolesToUser('userMongo', [{ role: "readWrite", db: "Sungero_dist_cache"}, { role: "readWrite", db: "Sungero_StorageService"}, { role: "readWrite", db: "sungero_ip_blocking"}, { role: "readWrite", db: "Sungero_HealthCheck"}]);

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

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

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

do all down

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

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

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

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

•DeploymentTool.zip – утилита DeploymentTool, если планируете ее использовать для публикации решений;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

13.Выполните обновление системы с версии 4.7 на 4.9.

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

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

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

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

DirectumRX\DirectumRXbase.dat

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

5.В версии 4.7 расширен диапазон идентификаторов для объектов системы. Если используется заказная или модифицированная разработка, то адаптируйте ее для перехода на большие ИД объектов.

6.В версии 4.7 из базового решения Directum RX удалены устаревшие элементы разработки. Адаптируйте код своей разработки, чтобы заменить устаревший код.

7.В версии 4.7 настройка схем типов задач на исполнение поручения (ActionItemExecutionTask), на рассмотрение (DocumentReviewTask) и ознакомление с документом (AcquaintanceTask) выполняется в веб-клиенте с помощью подхода no-code. Если в организации эти типы задач были перекрыты, то после обновления обеспечьте их корректную работу одним из способов:

•в веб-клиенте создайте варианты процессов для перекрытых типов задач (рекомендуемый способ). Подробнее о вариантах процессов стандартных типов задач см. в разделах «Исполнение поручений», «Рассмотрение документа», «Ознакомление с документом». Подход no-code продолжит развитие в следующих версиях. Поэтому, чтобы упростить дальнейшую поддержку старых задач, варианты процессов рекомендуется настроить при переходе на Directum RX 4.7;

•в среде разработки в редакторе каждого перекрытия типа задачи снимите флажок Схема настраивается в проводнике. В этом случае ранее заданная логика сохраняется, доработки не требуются.

8.В версии 4.7 уменьшена частота вызова события Возможность выполнения (CanExecute) для действий, которые доступны в дочерней коллекции: Копирование строки (CopyChildEntity), Удаление строки (DeleteChildEntity) и Добавление строки (AddChildEntity). Событие вычисляется один раз для всей коллекции, а не по отдельности для каждой записи. Если у вас уже разработаны свои действия для дочерних коллекций, то в новой версии для них также можно оптимизировать вызов события, установив новый флажок Проверять возможность выполнения один раз для коллекции. Подробнее в руководстве разработчика раздел «Оптимизация вычисления возможности выполнения действий».

9.В версии 4.7 создать подключение к базе данных можно с использованием оператора using для метода SQL.CreateConnection(). Он определяет область кода, в конце которой соединение автоматически закрывается. Также добавлена проверка программного кода. Если при создании подключения оператор using не используется, то при сборке решения появляется предупреждение «Соединение, полученное через SQL.CreateConnection(), необходимо освободить с помощью оператора using».

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

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

11.Выполните сборку решений.

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

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

13.Запустите инициализацию в среде разработки.

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

15.В версии 4.6 появилась возможность перенести выполнение кода сторонних сборок на сервис изолированного кода, чтобы обезопасить систему от возможных ошибок и нестабильности стороннего кода. Для этого в среде разработки создайте изолированную область в нужном модуле и подключите к ней стороннюю библиотеку.

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

17.С версии 4.6 схема новых типов задач по умолчанию настраивается в проводнике веб-клиента. Для таких задач в редакторе типа задачи установлен флажок Схема настраивается в проводнике. Ранее созданные типы задач остаются без изменений. Для них флажок не установлен, и схема по-прежнему настраивается в среде разработки. Подробнее см. руководство разработчика, раздел «Разработка задач и заданий».

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