# Загрузка расширений визуализации и управление ими Расширения добавляют настраиваемые возможности визуализации в приложения Qlik Cloud. Вы можете загружать расширения и управлять ими в центре активности Администрирование. Примечание о Qlik Cloud для правительстваВ Qlik Cloud для правительства поддерживаются расширения сторонних производителей. Их использование может потребовать утверждения в рамках разрешения на эксплуатацию агентства, в зависимости от требований безопасности и соответствия вашей организации. ## Использование расширений Расширения визуализации в Qlik Cloud добавляют новые визуальные компоненты, выходящие за рамки стандартных визуализаций. Используйте их, чтобы настроить способ представления и изучения данных. Для получения дополнительной информации см. раздел [Разработчик Qlik: расширение возможностей Qlik](https://qlik.dev/extend/). Для наглядной демонстрации см. [Использование сторонних расширений визуализации в Qlik Cloud](https://share.vidyard.com/watch/kq8gkpB6jfLuVDWERgAgXE?) и [Расширения и ключи API](https://share.vidyard.com/watch/KzZMkq1RDQVcnWc8ShfYje?). ## Необходимые роли Для загрузки расширений и управления ими необходимо иметь одну из следующих ролей: * Администратор клиента * Администратор Analytics * Пользовательская роль с разрешением Управление расширениями, установленным на Разрешено ## Требования к файлам и ограничения Следуйте этим правилам, чтобы убедиться, что ваше расширение загружается и работает правильно. ### Ограничения файлов 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)](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-content-security-policy.htm). ### Неподдерживаемые форматы файлов По соображениям безопасности расширениям не разрешается содержать файлы с запрещенными типами 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 переместил расширения из устаревшего хранилища в сервис, используемый для управления расширениями. Статус миграции указывает на текущее состояние миграции расширения. Значения статуса миграции: * Перенесено: Расширение успешно перенесено и доступно. * Недоступно: расширение больше недоступно и не может быть перенесено. Удалите расширение из центра активности Администрирование обратно. ## Добавление расширений Выполните следующие действия. 1. В центре активности Администрирование перейдите в раздел Расширения. 2. Щелкните Добавить. 3. Щелкните Обзор, чтобы выбрать файл расширения, или перетащите файл в обозначенную область. 4. Дополнительно можно добавить теги. 5. Нажмите Опубликовать. Примечание к информацииНельзя загрузить расширение, если имя файла QEXT совпадает с именем уже существующего расширения. ## Редактирование расширений Выполните следующие действия. 1. В центре активности Администрирование перейдите в раздел Расширения. 2. Щелкните the Дополнительно icon на расширении, которое необходимо отредактировать, и выберите Изменить. 3. Используйте панель редактирования, чтобы заменить расширение или обновить теги. 4. Сохранить изменения. ## Загрузка расширений Используйте это для резервного копирования расширения перед его редактированием или для перемещения в другой клиент. Выполните следующие действия. 1. В центре активности Администрирование перейдите в раздел Расширения. 2. На расширении, которое вы хотите загрузить, щелкните the Дополнительно icon и выберите Download. 3. Сохраните ZIP-файл. ## Удаление расширений Удаление расширений может привести к воздействию на все ресурсы, затрагивая всех пользователей клиента. Выполните следующие действия. 1. В центре активности Администрирование перейдите в раздел Расширения. 2. Выберите расширения, которые требуется удалить. 3. Щелкните команду Удалить.