Важно. С версии 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.В конфигурационном файле config.yml закомментируйте секции всех сервисов и утилит, кроме: IIS, ServiceRunner, SungeroWebServer, SungeroWebClient, IntegrationService, StorageService, DeploymentTool, RxCmd.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

13.Запустите сервисы системы. Для этого перейдите в режим Настройка, измените положение переключателя Визуальный режим конфигурирования и во встроенном редакторе YAML раскомментируйте секции сервисов и утилит. Нажмите на кнопку Применить настройки.

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

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

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

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

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

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

DirectumRX\DirectumRXbase.dat

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

5.С версии 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. Порядок настройки см. в руководстве администратора, раздел «Сервис асинхронных событий»;

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

6.С версии 4.7:

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

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

•переработана логика панели действий в карточках объектов. Если разработанные действия сущностей были добавлены на контекстную вкладку или на вкладку «Вложения», перенесите их на другие вкладки, иначе действия перестанут отображаться;

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

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

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

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

•простую задачу (SimpleTask) можно отправлять только от себя и от замещаемого сотрудника. Чтобы делать это от других пользователей, необходимо настроить для них права и замещения.

Также если в перекрытом типе задачи программно задана логика определения автора с помощью свойства Author (инициатор задачи), то после обновления при отправке задачи может возникнуть ошибка «Нельзя создать задачу от имени пользователя <Имя пользователя>».

Чтобы логика отработала корректно, в редакторе перекрытого типа задачи для свойства Author добавьте событие «Фильтрация выбора из списка» и снимите ограничение видимости пользователей. Для этого добавьте код:

public override IQueryable<T> AuthorFiltering(IQueryable<T> query, Sungero.Domain.PropertyFilteringEventArgs e)

{
  e.DisableUiFiltering = true;
  return query;
}

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

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

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

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

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

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

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

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