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

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

Расширения дополняют функции аналитической платформы Qlik Cloud, позволяя создавать пользовательские визуализации для приложений Qlik Sense. Расширения можно загружать и редактировать в центре активности Администрирование.

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

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

При создании и загрузке расширений визуализации в Qlik Cloud следуйте приведенным ниже инструкциям.

Для просмотра демонстрационного ролика о добавлении и использовании расширений см. Использование сторонних расширений для визуализации в Qlik Cloud и Расширения и ключи API.

Ограничения файлов ZIP для расширений

  • Максимальный размер файла ZIP: 30 МБ

  • Максимальный размер файлов в пакете ZIP: 30 МБ

  • Максимальное количество файлов в пакете ZIP: 500

  • Максимальный общий размер файлов без сжатия в пакете ZIP: 100 МБ

Оптимальные методы работы

  • Сократите размер файлов кода.

  • Включайте только необходимые файлы. Убедитесь, что файл ZIP содержит только файлы, необходимые для правильной работы расширения.

  • Проверьте расширения и их код перед загрузкой. Для получения дополнительной информации см. раздел Расширения визуализации (только английский язык).

Обязательные базовые файлы для расширения

Убедитесь, что файл ZIP расширения включает следующие основные файлы.

  • .qext: файл метаданных расширения

  • .js: код JavaScript для расширения

  • .html: HTML-код для отображения расширения

  • .css: пользовательский CSS для стиля расширения

Размещение файлов изображений на внешний ресурсах

Не загружайте файлы изображений (например, GIF, PNG, JPG) в файл ZIP расширения. Вместо этого размещайте их на внешних ресурсах — на личном сервере приложений, в блоке S3 или в общедоступной системе управления содержимым. Ссылайтесь на эти внешние изображения в коде расширения.

Ссылки на внешние файлы кода и содержимое

Можно добавлять в основной код расширения файлы кода и содержимое по ссылке, но для этого необходимо внедрить политику безопасности содержимого (CSP) для клиента. Для получения дополнительной информации см. раздел Управление Content Security Policy.

Если расширение отправляет запросы внешним ресурсам, эти источники ресурсов необходимо включить в список разрешенных в CSP, в противном случае отображение расширения будет заблокировано.

Неподдерживаемые функции

Следующие функции не поддерживаются.

Расширения, объединенные в пакет

Qlik Cloud не поддерживает файлы ZIP, содержащие другие файлы ZIP расширений.

Файлы QVD и QVD

Не включайте файлы QVF или QVD Qlik Sense в файл ZIP расширения, потому что к ним нельзя получить доступ из службы расширений. Удалите эти файлы перед загрузкой расширения.

Для загрузки файла QVF или QVD в клиент Qlik Cloud выполните одно из следующих действий.

  • Загрузите приложение на странице «Создать» в центре активности Аналитика.

  • Загрузите приложение, используя qlik-cli.

  • Загрузите QVD на странице Создать в центре активности Аналитика.

  • Загрузите файл QVD с помощью Qlik DataTransfer.

Неподдерживаемые форматы файлов

По соображениям безопасности расширениям не разрешается содержать файлы с запрещенными типами MIME. Типы 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.

Добавление расширений и управление ими

Управление расширениями осуществляется на странице Расширения в центре активности Администрирование.

В таблице Расширения:

  • Имя файла ― это имя метаданных в файле QEXT.

  • Версия QEXT ― это версия метаданных в файле QEXT.

  • Имя файла QEXT ― это уникальный идентификатор и имя файла определения расширения.

Расширения можно фильтровать по тегам.

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

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

  1. В центре активности Администрирование перейдите в раздел Расширения.
  2. Щелкните Добавить.

  3. Щелкните Обзор, чтобы выбрать файл расширения, или перетащите файл в обозначенную область.

  4. Дополнительно можно добавить теги.

  5. Нажмите Опубликовать.

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

Редактирование расширения

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

  1. В центре активности Администрирование перейдите в раздел Расширения.
  2. Щелкните Дополнительно на расширении, которое необходимо отредактировать, и выберите Изменить.

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

  3. Сохраните изменения.

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

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

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

  1. В центре активности Администрирование перейдите в раздел Расширения.
  2. Выберите расширения, которые требуется удалить.
  3. Нажмите Удалить.

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

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