Directum RX 4.0: Импортонезависимость, простая интеграция и ускорение разработки

Directum RX разворачивается на операционных системах Windows и Linux. Сервис интеграции позволяет объединить Directum RX с различными системами и создать единую цифровую экосистему организации. В среде разработки публикация изменений проходит «на лету», плюс появилась возможность перекрывать базовые типы документов и справочников. В статье об этих и других новинках версии Directum RX 4.0 для локальной установки.

Работа серверной части на Linux

В Directum RX уже поддерживается работа веб-клиента на операционных системах Альт Линукс, Astra Linux, которые входят в единый реестр отечественного ПО, и Ubuntu. С версии 4.0 на операционных системах Альт Линукс, Astra Linux и Ubuntu можно развернуть и серверную часть Directum RX.

Что нужно знать пользователю?

Пользователи могут работать в Directum RX с разных устройств и на разных операционных системах независимо от того, какая операционная система используется для серверной части. Для работы с клиентскими приложениями поддерживаются Linux, MacOS, Microsoft Windows. Для смартфонов и планшетов – iOS и Android.

Что нужно знать администратору?

• полностью поддерживается работа веб-сервера и всех сервисов на Linux. При этом на Linux работает только веб-клиент, его запросы обрабатывает веб-сервер. Сервер приложений на Linux ставить не требуется, так как он используется для обработки запросов десктоп-клиента;
• серверные компоненты Directum RX развертываются на Linux с помощью скриптов. Настройка выполняется с помощью конфигурационного файла. Для запуска и управления серверными компонентами используется программное обеспечение Docker;
• для балансировки нагрузки и отказоустойчивости сервисов Directum RX можно развернуть обратный прокси-сервер с использованием HAProxy. Прокси-сервер перенаправляет запросы клиентов из внешней сети на один или несколько серверов, расположенных во внутренней сети. При этом для клиента это выглядит так, будто запрашиваемые ресурсы находятся непосредственно на прокси-сервере;
• поддерживается аутентификация по паролю и внешняя аутентификация (LDAP, ЕСИА). Можно использовать сквозную аутентификацию по протоколам:
  • • Kerberos. Для работы с ним используется Active Directory, а также службы каталогов, которые зависят от дистрибутива Linux. Например, можно использовать Samba4;
    • WS-Federation, SAML 2.0 и OAuth 2.0 с помощью внешнего провайдера Active Directory Federation Services (ADFS);
• для подписания документов используются алгоритмы RSA и ГОСТ. Также поддерживается разработка своих плагинов подписания на основе шаблона из репозитория GitHub.

Для удобства изучения вся информация по администрированию Directum RX на Linux вынесена в раздел справки:

Что нужно знать разработчику?

• среда разработки Directum RX устанавливается только на компьютер с операционной системой Microsoft Windows. Чтобы проверить разработанный код в системе на базе Linux, потребуется выделить тестовый стенд с Linux, развернуть все сервисы и проверить на нем свои доработки;
• при переносе серверной части Directum RX c Microsoft Windows на Linux прикладной код, который вы написали, остается полностью работоспособным. Достаточно обновить прикладную разработку на сервере с Linux;
• начиная с версии 4.0, утилита DeploymentTool может публиковать пакеты разработки в продуктивную систему, развернутую на серверах с Microsoft Windows и Linux. Для этого используются пакеты разработки, созданные по спецификации NET Standard вместо NET Framework. Новые пакеты визуально ничем не отличаются от пакетов прежних версий. Они также создаются в среде разработки с помощью экспорта. Единственное, что нужно сделать перед публикацией, – убедиться, что в конфигурационном файле утилиты для параметра USE_NET_STANDARD установлено значение True;
• в Linux временно не поддерживается интеграция с 1С, автоматическое подписание извещений о получении документов из сервисов обмена, шаблон интеграции с Active Directory;
• не поддерживается вызов публичных клиентских функций через утилиту DrxUtil. Чтобы обращаться к клиентским функциям, в среде разработки для функций нужно добавить атрибут Hyperlink и настроить их вызов из внешней системы;
• не поддерживаются шаблон интеграционного решения Web API. Для объединения Directum RX с внешними системами необходимо использовать новый сервис интеграции.

Новые возможности для простой интеграции

Объединить Directum RX с другой системой можно с помощью готовых интеграционных решений. До версии 4.0, если подходящего решения не было, разработчики адаптировали под свои задачи шаблон интеграционного решения Web API. В новой версии на смену шаблону создан сервис интеграции, который поставляется сразу вместе с системой, а не как отдельное решение.

Сервис умеет получать от внешней системы HTTP-запросы по веб-протоколу OData и выполнять их. Полученный результат (ответ) преобразовывается в формат JSON и передается внешней системе.

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

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

Структурированные лог-файлы

Ранее информация о работе системы записывалась в лог-файлы в виде простых строк. Теперь лог-файлы ведутся в структурированном виде в формате JSON. Это обеспечивает единый формат лог-файлов и упрощает их автоматизированный анализ.

Для удобного просмотра лог-файлов рекомендуется использовать утилиты, которые открывают их в форматированном виде: Notepad++, Visual Studio Code, LogExpert и т.п. Стандартную функциональность Notepad++ можно расширить плагином JSTool.

Кроме того, с помощью утилиты DirectumLogConverter можно сконвертировать лог-файл:

• в простой текст – для чтения в любом текстовом редакторе;
• в формат CSV – для обработки, например, в Microsoft Excel.

Если для анализа лог-файлов используется решение «Мониторинг системы Directum RX», то дополнительная настройка решения не требуется. Новая версия решения поддерживает структурированный формат. Если в компании используются свои инструменты мониторинга, то при переходе на Directum RX 4.0 нужно перенастроить анализ лог‑файлов на формат JSON.

Оптимизация, отказоустойчивость и стабильность работы

• Для решения задач бизнеса ИТ-инфраструктура должна быть отказоустойчивой и масштабируемой. В версии 4.0 улучшена работа при подключении веб-сервера и сервисов к кластерам Redis и RabbitMQ в распределенной среде. Проведено нагрузочное тестирование и проверена отказоустойчивость при разворачивании кластеров. Даже если один из узлов кластера выйдет из строя, остальные продолжат функционировать.
• Чтобы снизить нагрузку на веб-сервер, приложение Centrifugo теперь подключается сразу к сервису клиентских подключений (ClientsConnectionService), минуя веб-сервер. При входе пользователя в веб-клиент Centrifugo отправляет запрос на авторизацию сервису клиентских подключений. Для этого в параметрах сервиса ClientsConnectionService теперь задается порт, по которому он принимает соединение с приложением Centrifugo.
• Повышена стабильность работы при открытии в предпросмотре документов форматов PDF, PPT и PPTX. Для документов этих форматов конвертация выполняется постранично: по мере прокрутки документа. Все описания файлов предпросмотра хранятся в базе данных MongoDB, которая предоставляет средства для работы с файлами и их содержимым. В требования к серверам добавлена поддержка базы данных MongoDB 4.2.

Отключение десктоп-клиента

С версии 4.0 веб-клиент стал основным, поэтому по умолчанию десктоп-клиент отключен. При попытке его запустить появится поясняющее сообщение со ссылкой на веб-клиент.

Перейти с привычного десктоп-клиента Directum RX на веб легко и без ущерба для рабочего процесса поможет цикл статей, который выйдет на Directum Club в ближайшее время. С первой статьей вы можете ознакомится уже сейчас. Чтобы не пропустить остальные, подписывайтесь на тег Переход на веб-клиент.

Изменения среды разработки

Новинки среды разработки нацелены на ускорение и упрощение разработки, а также на расширение функциональности Directum RX.

Перекрытие базовых типов сущностей

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

Предположим, в карточку договора (Contract) и дополнительного соглашения (SupAgreement) нужно добавить поле Куратор, которое позволит отслеживать ответственного по документам. Для этого на рабочем слое достаточно перекрыть базовый тип договорного документа (ContractualDocument), в его редакторе добавить свойство Куратор и разместить соответствующий контрол на форме. В итоге в карточках договоров и дополнительных соглашений появится поле Куратор, которое позволит отслеживать ответственного по документам.