Функции дополнительных компонентов платформы

Python-ноутбуки

Для возможности создания аналитических расчетов, отладки итерационных или оптимизационных расчетов, использующих данные НСИ и исторических архивов, накопленные в платформе, используются интегрированные в платформу JupyterNotebook'и.

Jupyter Notebook -- это веб-интерфейс для написания, запуска и отладки скриптов на языке python. Интерфейс представляет пользователю в формате «тетрадки» писать скрипты python с возможностью их исполнения по частям (ячейкам) или целиком. Хранение скриптов организовано в виде отдельных директорий. Есть система разграничения доступа пользователей, интегрированная в общую систему ПРОСТОР.

Кроме того, есть возможность связывания созданных python-ноутбуков с интерфейсами Grafana. Для этого в платформе разворачивается специальный сервис, реализующий API для запуска ноутбуков с возможностью передачи пользовательских параметров из Grafana в python ноутбук. Результатом выполнения расчета в ноутбуке могут быть как запись в БД, так и сформированные отчеты excel, выгрузка в форматы csv, excel или другие.

Для создания панелей интерактивного запуска используется специальный плагин Business forms. Он позволяет создавать интерактивные элементы с различными элементами управления: выпадающие списки, галочки для выбора, выбор времени, текстовые или числовые поля ввода, загрузка файла и другие.

При этом при нажатии на кнопку пользователем выполняется POST запрос по указанному адресу: https://app-name/calculation-api с телом запроса в виде json, в котором передаются значения элементов управления создаваемой панели. Обязательным параметром является значение ключа "Notebook", в котором указывается относительный путь до файла python ноутбука. Остальные параметры могут иметь произвольные имена. Они также будут переданы и использованы при исполнении скрипта python ноутбука за счет подстановки в ячейке ноутбука с тегом «parameters».

При вызове специального API запуска ноутбуков в k3s разворачивается отдельный контейнер, в котором с помощью специального python пакета papermill запускается исполнение указанного python ноутбука. После окончания исполнения скрипта этот контейнер заканчивает свою работу и высвобождает используемые для своей работы вычислительные ресурсы.

Сервер документов OnlyOffice

Для возможности просмотра, редактирования и совместной работы с офисными документами в веб-интерфейсе, особенно с электронными таблицами, в платформу интегрирован компонент OnlyOffice. Этот компонент предоставляет возможность работы в веб-интерфейсе с электронными таблицами, например отчётами, которые были сохранены в результате работы python-ноутбуков.

Компонент состоит из двух частей: documentServer'а и python-клиента, реализующего взаимодействие с сервером, запуск редакторов и возможность управления файлами.