Пакеты
Во вкладке Пакеты отображается список пакетов, добавленных в пространство. Пакет — это ZIP-архив, содержащий шаблон пространства или виджет.
Для просмотра вкладки Пакеты пользователь должен иметь привилегию Пространство с операцией Изменение (W) или доступ к пространству на изменение.
Добавить пакет в пространство можно из Маркетплейса или из локального хранилища.
Добавление пакета из локального хранилища
Чтобы добавить пакет из локального хранилища, во вкладке Пакеты нажмите + Добавить. В появившемся модальном окне нажмите на область и выберите архив или переместите его в область. Нажмите Импортировать.
Если в импортированном пакете не хранились подключения, он добавляется сразу. Если в пакете хранились подключения, при переходе во вкладку Панель управления в левой части экрана появляется панель настройки подключений.
Настройте все подключения и нажмите Продолжить.
- При ненастроенных подключениях у добавленного компонента могут работать не все функции.
- Если пакет включает скрипты, они становятся видимыми в пространстве только после его разбора.
- Разобранный пакет нельзя обновить.
Действия для пакетов
Для пакетов, добавленных из Маркетплейса, доступны следующие действия в контекстном меню:
- Перейти в пакет (переход на страницу пакета в Маркетплейсе)
- Разобрать (предоставление доступа на редактирование всех объектов, хранящихся в пакете. Недоступно для виджетов)
- Обновить (обновление пакета на версию, хранящуюся в Маркетплейсе)
- Удалить (удаление пакета со всеми объектами, хранящимися в пакете)
Для пакетов, добавленных из локального хранилища, доступны следующие действия в контекстном меню:
- Новая версия (загрузка новой версии пакета)
- Разобрать (предоставление доступа на редактирование всех объектов, хранящихся в пакете. Недоступно для виджетов)
- Удалить (удаление пакета со всеми объектами, хранящимися в пакете)
При разборе пакета в пространстве все его объекты становятся доступны для редактирования. Если объект содержится в нескольких пакетах, он становится доступным для редактирования, только если разобраны все пакеты, содержащие этот объект.
Статус пакетов
Пакет, добавленный из Маркетплейса, может иметь следующие статусы:
- Актуальная версия (если версия пакета совпадает с версией пакета, хранящейся в Маркетплейсе)
- Доступно обновление (если версия пакета не совпадает с версией пакета, хранящейся в Маркетплейсе)
Пакетам, добавленным в пространство из локального хранилища, присваивается статус Пользовательский.
Если в пакете хранились виджеты, то после того, как пакет разобран, виджеты отображаются в общем списке пакетов со статусом Пользовательский. Разобранный пакет удаляется из списка.
Поддержка нескольких версий пользовательских виджетов в пространстве
В пространстве может храниться несколько версий одного пользовательского виджета одновременно. Это обеспечивает корректную работу дашбордов из установленных пакетов при обновлении виджетов.
Дашборды, которые входят в состав установленных пакетов, используют версию виджета, указанную в зависимостях пакета (файл manifest.json).
Пример: в пространстве установлен пакет, зависящий от пользовательского виджета версии 7.0. В Маркетплейсе вышло обновление виджета до версии 8.0, и пакет с виджетом в пространстве был обновлен. Дашборды из установленного пакета продолжат отображать виджет версии 7.0 без ошибок. Если в пространстве есть другие пакеты, которые зависят от версии 8.0, они будут использовать новую версию.
Если для пользовательского виджета, который используется в установленных пакетах, доступна новая версия, то появится соответствующее уведомление.
При разборе пакета с дашбордом появится предупреждение о том, что пользовательские виджеты в дашбордах этого пакета будут обновлены до актуальной версии. После разбора пакета дашборды начнут использовать последнюю доступную версию виджета.
В дашбордах, созданных вручную и не принадлежащих пакетам, всегда применяется последняя доступная версия пользовательского виджета.
Хранение версий виджетов
Во вкладке Пакеты отображается только последняя версия пользовательского виджета. Предыдущие версии сохраняются в пространстве, пока они используются в установленных пакетах. Когда ни один пакет больше не использует старую версию виджета, она удаляется автоматически.
При экспорте пространства экспортируются все версии пользовательских виджетов.
Доступ приложений к ресурсам пространства
Приложения (пакеты типа application) можно связать с пространством: тогда приложение получает доступ к таблицам ClickHouse, скриптам, файловому хранилищу и интеграциям пространства. Список доступных ресурсов задается при публикации приложения в Маркетплейсе.
Была ли статья полезна?