Перейти к основному содержимому

Управление расширениями

Управление расширениями производится на странице Расширения в Management Console.

Примечание о Qlik Sense Enterprise SaaS GovernmentВ Qlik Sense Enterprise SaaS - Government (US) поддерживаются расширения сторонних производителей. В зависимости от требований, установленных в организации в отношении безопасности и соответствия, для использования расширений сторонних производителей может потребоваться определение расширений в составе Агентства на осуществления деятельности и получения соответствующих разрешений.

Для расширений, запрашивающих внешние ресурсы, необходимо включить в список разрешений в 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'
Примечание об информацииВсе файлы расширения должны иметь имя файла и файловое расширение. Файлы, не отвечающие этому условию, игнорируются. Примеры игнорируемых файлов: .gitignore и README.

Инструкции по созданию и загрузке расширений

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.

Добавление нового расширения

Выполните следующие действия.

  1. В Management Console откройте раздел Расширения и нажмите в верхнем правом углу Добавить.
  2. Во всплывающем окне щелкните Обзор, чтобы выбрать файл расширения, или перетащите файл в обозначенную область.

    Примечание об информацииНельзя загрузить расширение, если имя файла QEXT совпадает с именем уже существующего расширения.
  3. Дополнительно можно добавить теги.

  4. Щелкните Опубликовать.

  5. Если в загруженном расширении содержатся внешние ресурсы, необходимо добавить источники ресурсов в список разрешений в Content Security Policy. См. Управление Content Security Policy.

Изменение расширения

Можно менять только одно расширение.

Выполните следующие действия.

  1. В Management Console откройте раздел Расширения и отметьте флажком расширение, которое нужно изменить.
  2. В правом верхнем углу щелкните Изменить.

    Отобразится панель редактирования с параметрами для замены существующего расширения, а также для добавления или удаления тегов.

  3. Выполните необходимые изменения и сохраните их.

Удаление расширения

Выполните следующие действия.

  1. В Management Console откройте раздел Расширения и отметьте флажками расширения, которые нужно удалить.
  2. В правом верхнем углу щелкните Удалить.
Примечание об информацииУдаление расширений может повлиять на все ресурсы. Удаление влияет на всех пользователей внутри клиента.