4.2. Использование сторонних библиотек. Создание микросервиса On-Premises

Если для решения задачи необходимо подключить в систему стороннюю библиотеку, можно использовать:

• сценарии в виджетах для подключения .js-библиотек, работающих в браузере;
• собственные микросервисы для подключения любых библиотек (для On-Premises).

Подключение .js-библиотек

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

Чтобы подключить библиотеку, перейдите в дизайнере интерфейсов на вкладку Файлы. Загрузите один или несколько файлов в формате .js. На вкладке Сценарии в исходном коде скрипта подключите добавленные файлы с помощью инструкции import.

Например, чтобы подключить библиотеку jQuery, перейдите на вкладку Файлы и загрузите файл с актуальной версией библиотеки, например, jquery-3.6.0.min.js. Перейдите на вкладку Сценарии в раздел клиентских сценариев и в начале сценария добавьте инструкцию:

Код:

import $ from "jquery-3.6.0.min.js";

Теперь в коде сценария можно обращаться к функциям библиотеки.

Подключение любых библиотек On-Premises

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

Создание микросервиса On-Premises

Вы можете создать свой сервис и разместить его внутри кластера k8s. Это позволит расширить функциональные возможности системы. Например, можно создать сервис для работы с файлами .xlsx. Он будет считывать строки и сохранять их в приложения.

Создавать свой сервис нужно тогда, когда без него нельзя решить задачу. Сценарии использования сервиса:

• реализация интеграции с внешней системой через непопулярные интерфейсы. Например:
  • интеграция с 1С через COM-Connector;
  • интеграция напрямую с базами данных, например, Oracle;
• реализация сложных вычислений, например, распознавание документов;
• подключение библиотек, например, использование библиотеки Aspose для работы с файлами MS Office в сценариях;
• сервис может быть написан на любом языке программирования, для развёртывания его внутри ELMA365 требуется только Docker-образ.

Ознакомиться с детальным примером создания и подключения сервиса можно в справке.