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

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

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

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

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

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

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!