Загрузка расширений визуализации и управление ими

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

В Qlik Cloud для правительства поддерживаются расширения сторонних производителей. Их использование может потребовать утверждения в рамках разрешения на эксплуатацию агентства, в зависимости от требований безопасности и соответствия вашей организации.

Использование расширений

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

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

Необходимые роли

Для загрузки расширений и управления ими необходимо иметь одну из следующих ролей:

Администратор клиента
Администратор аналитики
Пользовательская роль с разрешением Управление расширениями, установленным на Разрешено

Требования к файлам и ограничения

Следуйте этим правилам, чтобы убедиться, что ваше расширение загружается и работает правильно.

Ограничения файлов

ZIP-файлы расширений имеют следующие ограничения:

Максимальный размер файла ZIP: 30 МБ
Максимальный размер любого отдельного файла в ZIP-архиве: 30 МБ
Максимальное количество файлов в пакете ZIP: 500
Максимальный общий размер без сжатия: 100 МБ

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

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

.qext: Файл метаданных
.js: Код JavaScript
.html: Код рендеринга HTML
.css: Пользовательский стиль

Правила именования файлов

Каждый файл в расширении должен иметь имя файла и расширение файла. Файлы, не отвечающие этому условию, игнорируются. Примеры игнорируемых файлов: .gitignore и README.

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

Сократите размер своих файлов кода.
Включайте только те файлы, которые необходимы вашему расширению для работы.
Проверьте расширение и его код перед загрузкой.

Внешние ресурсы и CSP

Размещайте файлы изображений извне

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

Ссылки на внешний код и контент

Чтобы ссылаться на внешний код или контент в вашем расширении, настройте политику безопасности контента клиента (CSP) и добавьте в список разрешенных внешние источники, к которым ваше расширение должно иметь доступ.

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

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

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

По соображениям безопасности расширениям не разрешается содержать файлы с запрещенными типами MIME. Типы MIME (многоцелевые расширения интернет-почты) указывают формат файла. Если ваше расширение содержит запрещенный тип MIME (например, исполняемый файл или ZIP-файл), загрузка завершится ошибкой.

Следующие типы MIME запрещены:

'приложение/octet-поток'
'приложение/x-coredump'
'приложение/x-dosexec'
'приложение/x-исполняемый'
'приложение/x-java-апплет'
'application/x-объект'
'application/x-разделяемая-библиотека'
'application/zip'
'текст/x-скрипт-оболочки'
'текст/x-awk'
'текст/x-gawk'
'текст/x-пакетный-файл-msdos'
'текст/x-nawk'
'text/x-php'

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

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

Пакетные расширения: ZIP-файлы, содержащие другие ZIP-файлы расширений, не поддерживаются.
Файлы QVF и QVD: Эти файлы недоступны из службы расширений.

Чтобы загрузить файлы QVF или QVD, используйте один из следующих методов:

Загрузите приложение со страницы Создать в центре активности Аналитика.
Загрузите приложение с помощью qlik-cli.
Загрузите QVD со страницы Создать в центре активности Аналитика.
Загрузите QVD с помощью Qlik DataTransfer.

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

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

Информация о таблице расширений

Имя: Имя метаданных в файле QEXT
Версия QEXT: Версия метаданных
Имя файла QEXT: Уникальный идентификатор файла определения расширения
Статус: Статус миграции (временно)

О статусе миграции

Qlik улучшает обработку расширений платформой. Во время этого перехода существующие расширения перемещаются в новую службу. Столбец состояния миграции является временным и отображается только во время выполнения этой работы.

По состоянию на 2025-11-17 любое расширение, которое вы загружаете или к которому обращаетесь, автоматически использует новую службу. Если ваше расширение используется регулярно, никаких действий не требуется.

Большинство расширений мигрируют автоматически при их использовании. Расширения, которые вы не использовали недавно, возможно, потребуется добавить в очередь вручную, чтобы они были включены в запланированный запуск миграции. Чтобы защитить контент, принадлежащий клиентам, Qlik не переносит расширения, если к ним не был осуществлен доступ или вы не подтвердили миграцию. Если вы хотите сохранить доступным неиспользуемое расширение (статус Не перенесено), вы можете перенести его вручную.

Значения статуса миграции:

Не перенесено: Расширение не было перенесено.
Поставлено в очередь на миграцию: Расширение поставлено в очередь и будет перенесено во время следующего запланированного запуска миграции.
Миграция выполняется: Расширение в настоящее время переносится.
Перенесено: Расширение успешно перенесено.

Миграция также применяется к темам. Для получения подробных сведений см. раздел Загрузка тем и управление ими.

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

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

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

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

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

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

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