Управление расширениями
Управление расширениями производится на странице Расширения в Консоль управления.
Для расширений, запрашивающих внешние ресурсы, необходимо включить в список разрешений в Content Security Policy источники, в противном случае представление таких расширений будет заблокировано.
Для просмотра демонстрационного ролика о добавлении и использовании расширений см. Использование сторонних расширений для визуализации в Qlik Cloud и Расширения и ключи API.
Обзор страницы «Расширения»
На странице Расширения Консоль управления отображаются следующие свойства.
Свойство | Описание |
---|---|
Имя |
Это имя метаданных, содержащихся в файле QEXT, который отличается от имени файла QEXT. |
Описание |
Краткое описание расширения. |
Теги |
Теги для фильтрации. |
Автор |
Создатель расширения. |
Имя файла QEXT |
Идентификатор, который должен быть уникальным. Имя файла определения расширения. Отличается от имени расширения. |
Версия QEXT |
Версия метаданных, содержащихся в файле QEXT. |
Опубликовано |
Дата публикации. |
В таблице сортировка осуществляется с помощью стрелок в заголовке свойств. Выполните фильтрацию с помощью раскрывающегося меню Теги, или выбрав теги в таблице.
Расширения с внешними ресурсами
Для расширений, запрашивающих внешние ресурсы, необходимо включить в список разрешений в Content Security Policy источники, в противном случае представление таких расширений будет заблокировано.
См. также:Управление Content Security Policy
Неподдерживаемые форматы файлов
По соображениям безопасности расширениям не разрешается содержать файлы с запрещенными типами 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 Cloud и Qlik Sense Enterprise Client-Managed используют различные службы расширений, следовательно, их возможности различны. При создании и загрузке расширений визуализации в Qlik Cloud необходимо следовать указанным ниже инструкциям.
-
В отношении файлов ZIP, содержащих расширения, действуют следующие ограничения:
-
Максимальный размер файла ZIP: 30 МБ
-
Максимальный размер файлов в пакете ZIP: 30 МБ
-
Максимальное количество файлов в пакете ZIP: 500
-
Максимальный общий размер файлов без сжатия в пакете ZIP: 100 МБ
-
-
Сократите размер своих файлов кода.
-
Включайте в файл zip расширения только файлы, необходимые для правильного функционирования расширения. В таблице показаны основные файлы, требуемые для расширения визуализации.
Расширение файла Описание .qext Файл метаданных расширения .js Код JavaScript для расширения .html
HTML-код для отображения расширения .css Пользовательский CSS для стиля расширения
-
Не загружайте файлы изображений. GIF, PNG, JPG и другие файлы изображений следует размещать на внешних ресурсах — на личном сервере приложений, в блоке S3 или на общедоступной системе управления содержимым. На них можно ссылаться в коде расширения.
Примечание к информацииМожно ссылаться на некоторые файлы кода и содержимое из основного кода расширения. Для ссылки на внешнее содержимое из расширения необходимо внедрить политику безопасности содержимого на клиенте. Для получения более подробной информации см. раздел Управление Content Security Policy. -
Служба расширений Qlik Cloud не поддерживает расширения, объединенные в пакет (файл zip, содержащий другие файлы zip расширений).
-
Не загружайте расширения, в которые входят файлы QVF или QVD Qlik Sense, потому что к ним нельзя получить доступ из службы расширений. Удалите эти файлы перед загрузкой расширения.
-
Для загрузки файла QVF или QVD в клиент Qlik Cloud выполните одно из следующих действий.
-
Загрузите приложение из облачного хаба.
-
Загрузите приложение, используя qlik-cli.
-
Загрузите файл QVD из облачного хаба.
-
Загрузите файл QVD с помощью Qlik DataTransfer.
-
Добавление нового расширения
Выполните следующие действия.
- В Консоль управления откройте раздел Расширения и нажмите в верхнем правом углу Добавить.
-
Во всплывающем окне щелкните Обзор, чтобы выбрать файл расширения, или перетащите файл в обозначенную область.
Примечание к информацииНельзя загрузить расширение, если имя файла QEXT совпадает с именем уже существующего расширения. -
Дополнительно можно добавить теги.
-
Щелкните Опубликовать.
-
Если только что загруженное расширение содержит внешние ресурсы, необходимо добавить в список разрешений источники в Content Security Policy. См. Управление Content Security Policy.
Изменение расширения
Можно менять только одно расширение.
Выполните следующие действия.
- В Консоль управления откройте раздел Расширения и отметьте флажком расширение, которое нужно изменить.
-
В правом верхнем углу щелкните Изменить.
Отобразится панель редактирования с параметрами для замены существующего расширения, а также для добавления или удаления тегов.
-
Выполните необходимые изменения и сохраните их.
Удаление расширения
Выполните следующие действия.
- В Консоль управления откройте раздел Расширения и отметьте флажками расширения, которые нужно удалить.
- В правом верхнем углу щелкните Удалить.