Управление расширениями
Управление расширениями производится на странице Расширения в Management Console.
Для расширений, запрашивающих внешние ресурсы, необходимо включить в список разрешений в Content Security Policy источники, в противном случае представление таких расширений будет заблокировано.
Для просмотра демонстрационного ролика о добавлении и использовании расширений см. Использование сторонних расширений для визуализации в Qlik Cloud и Расширения и ключи API.
Обзор страницы «Расширения»
На странице Расширения Management Console отображаются следующие свойства.
Свойство | Описание |
---|---|
Имя |
Это имя метаданных, содержащихся в файле QEXT, который отличается от имени файла QEXT. |
Описание |
Краткое описание расширения. |
Теги |
Теги для фильтрации. |
Автор |
Создатель расширения. |
Имя файла QEXT |
Идентификатор, который должен быть уникальным. Имя файла определения расширения. Отличается от имени расширения. |
Версия QEXT |
Версия метаданных, содержащихся в файле QEXT. |
Опубликовано |
Дата публикации. |
В таблице сортировка осуществляется с помощью стрелок в заголовке свойств. Выполните фильтрацию с помощью раскрывающегося меню Теги, или выбрав теги в таблице.
Расширения с внешними ресурсами
Для расширений, запрашивающих внешние ресурсы, необходимо включить в список разрешений в Content Security Policy источники, в противном случае представление таких расширений будет заблокировано.
См. также:Управление Content Security Policy
Неподдерживаемые форматы файлов
Максимальный размер файла в папке расширений составляет 15 МБ.
По соображениям безопасности расширениям не разрешается содержать файлы с запрещенными типами MIME. Загрузка завершится ошибкой, если в расширении будет содержаться, например, исполняемый файл или файл zip. Следующие типы MIME запрещены:
- 'application/octet-stream'
- 'application/x-coredump'
- 'application/x-dosexec'
- 'application/x-executable'
- 'application/x-java-applet'
- 'application/x-object'
- 'application/x-sharedlib'
- 'application/zip'
- 'text/x-shellscript'
- 'text/x-awk'
- 'text/x-gawk'
- 'text/x-msdos-batch'
- 'text/x-nawk'
- 'text/x-php'
Инструкции по созданию и загрузке расширений
Qlik Sense SaaS и Qlik Sense Enterprise Client-Managed используют различные службы расширений, следовательно, их возможности различны. При создании и загрузке расширений визуализации в Qlik Sense SaaS необходимо следовать указанным ниже инструкциям.
-
Размер файла zip расширения должен составлять меньше 15 МБ. Это обеспечивает загрузку расширений без тайм-аута и проблем.
-
Сократите размер своих файлов кода.
-
Включайте в файл zip расширения только файлы, необходимые для правильного функционирования расширения. В таблице показаны основные файлы, требуемые для расширения визуализации.
Расширение файла Описание .qext Файл метаданных расширения .js Код JavaScript для расширения .html
HTML-код для отображения расширения .css Пользовательский CSS для стиля расширения
-
Не загружайте файлы изображений. GIF, PNG, JPG и другие файлы изображений следует размещать на внешних ресурсах — на личном сервере приложений, в блоке S3 или на общедоступной системе управления содержимым. На них можно ссылаться в коде расширения.
Примечание об информацииМожно ссылаться на некоторые файлы кода и содержимое из основного кода расширения. Для ссылки на внешнее содержимое из расширения необходимо внедрить политику безопасности содержимого на клиенте. Для получения более подробной информации см. раздел Управление Content Security Policy. -
Служба расширений Qlik Sense SaaS не поддерживает расширения, объединенные в пакет (файл zip, содержащий другие файлы zip расширений).
-
Не загружайте расширения, в которые входят файлы QVF или QVD Qlik Sense, потому что к ним нельзя получить доступ из службы расширений. Удалите эти файлы перед загрузкой расширения.
-
Для загрузки файла QVF или QVD в клиент Qlik Sense SaaS выполните одно из следующих действий.
-
Загрузите приложение из облачного хаба.
-
Загрузите приложение, используя qlik-cli.
-
Загрузите файл QVD из облачного хаба.
-
Загрузите файл QVD с помощью Qlik DataTransfer.
-
Добавление нового расширения
Выполните следующие действия.
- В Management Console откройте раздел Расширения и нажмите в верхнем правом углу Добавить.
-
Во всплывающем окне щелкните Обзор, чтобы выбрать файл расширения, или перетащите файл в обозначенную область.
Примечание об информацииНельзя загрузить расширение, если имя файла QEXT совпадает с именем уже существующего расширения. -
Дополнительно можно добавить теги.
-
Щелкните Опубликовать.
-
Если в загруженном расширении содержатся внешние ресурсы, необходимо добавить источники ресурсов в список разрешений в Content Security Policy. См. Управление Content Security Policy.
Изменение расширения
Можно менять только одно расширение.
Выполните следующие действия.
- В Management Console откройте раздел Расширения и отметьте флажком расширение, которое нужно изменить.
-
В правом верхнем углу щелкните Изменить.
Отобразится панель редактирования с параметрами для замены существующего расширения, а также для добавления или удаления тегов.
-
Выполните необходимые изменения и сохраните их.
Удаление расширения
Выполните следующие действия.
- В Management Console откройте раздел Расширения и отметьте флажками расширения, которые нужно удалить.
- В правом верхнем углу щелкните Удалить.