Данные и перезагрузка
Последнее обновление: 14.10.2026QV2QS преобразует пользовательский интерфейс QlikView и может автоматически загружать данные в преобразованное приложение с помощью параметра Auto-binary. Включите Reload и Auto-binary в мастере или в командной строке, и QV2QS выполнит передачу данных автоматически. Если Auto-binary не используется, преобразованное приложение необходимо перезагрузить отдельно для заполнения данными.
QV2QS преобразует метаданные пользовательского интерфейса QlikView (PRJ XML) в JSON Qlik Sense и собирает приложение непосредственно в клиенте Qlik Cloud. Процесс преобразования обрабатывает макеты листов, объекты визуализации, выражения и стили. Без перезагрузки полученное приложение Qlik Sense не содержит данных после завершения шага сборки.
Чтобы заполнить преобразованное приложение данными, приложение необходимо перезагрузить. Существует три подхода:
- Автоматическая загрузка двоичного файла — QV2QS загружает исходный файл QVW в Qlik Cloud и использует оператор
Binaryдля загрузки данных во время сборки. Этот подход — самый быстрый способ увидеть работающее приложение с данными сразу после конвертации. Для получения подробных сведений см. раздел Автоматическая загрузка двоичного файла ниже. - Ручная перезагрузка — если подключения к данным уже созданы в Qlik Cloud и файлы QVD или источники данных доступны, приложение можно перезагрузить после корректировки Скрипта загрузки. QV2QS применяет базовую нормализацию путей Скрипта загрузки, но имена подключений и пути к источникам данных могут потребовать ручного обновления.
- Инициированная перезагрузка — используйте флаг
--reload, чтобы инициировать перезагрузку в рамках развертывания. Перезагрузка выполняет Скрипт загрузки без изменений. Перезагрузка завершается успешно, только если подключения к данным и источники данных, на которые ссылается Скрипт загрузки, уже доступны в среде Qlik Cloud.
Два флага управляют данными на разных этапах. Флаг --noData пропускает данные на этапе сборки, что позволяет протестировать структуру приложения, не дожидаясь перезагрузки. Флаг --exportQvfNoData экспортирует QVF без данных после завершения сборки, создавая файл меньшего размера для совместного использования. Флаги можно использовать по отдельности или вместе.
Автоматическая загрузка двоичного файла
Автоматическая загрузка двоичного файла загружает исходный файл QVW в Qlik Cloud, использует оператор Binary для загрузки данных в преобразованное приложение, а затем удаляет загруженный файл. Преобразованное приложение получает те же данные, что и оригинал QlikView, без необходимости ручной настройки подключения к данным.
Чтобы включить автоматическую загрузку двоичного файла, используйте --autoBinary в командной строке или включите Auto-binary в пользовательском интерфейсе.
QV2QS выполняет следующие действия, когда включена автоматическая Загрузка двоичного файла:
- Загрузите файл QVW в Qlik Cloud как временное приложение.
- Добавьте оператор
Binary [<appId>];и операторExit Script;в начало Скрипта загрузки преобразованного приложения. - Соберите приложение (и выполните перезагрузку, если указан
--reload), которое загружает данные из загруженного QVW. - Удаление временно загруженного приложения из Qlik Cloud.
- Восстановите исходный Скрипт загрузки в приложении Qlik Cloud, удалив операторы Binary и Exit Script.
После очистки приложение Qlik Cloud содержит загруженные данные, но Скрипт загрузки больше не ссылается на временное приложение.
На этап загрузки распространяются ограничения Qlik Cloud по размеру файла. Большие файлы QVW могут превышать лимит на загрузку для уровня подписки клиента. Если загрузка не удалась, разверните приложение в пространстве с включенной поддержкой больших приложений или используйте аргумент --binaryAppId, чтобы сослаться на существующее приложение, уже находящееся в Qlik Cloud. Для получения подробных сведений об ограничениях ресурсов клиента см. Ограничения ресурсов Qlik Cloud.
Очистка при сбое
Если этап сборки или перезагрузки завершается сбоем после загрузки файла QVW, QV2QS автоматически пытается выполнить очистку перед выходом. Очистка включает в себя удаление временно загруженного приложения из Qlik Cloud и восстановление исходного Скрипта загрузки как локально, так и в облачном приложении.
Если сама очистка завершится сбоем (например, из-за прерывания сетевого соединения), временное приложение может остаться в клиенте Qlik Cloud. Осиротевшие временные приложения называются QV2QS_Binary_YYYYMMDD_HHMMSS (например, QV2QS_Binary_20260219_143025). Проверьте целевое пространство на наличие приложений, соответствующих этому шаблону, и удалите их вручную. Локальный файл script.qvs в каталоге сборки также может содержать временную инструкцию Binary. Повторно запустите преобразование, чтобы сгенерировать его заново.
Для автоматической загрузки двоичного файла требуются флаг --reload и путь --qvw. QV2QS отклоняет команду и завершает работу с кодом 1, если отсутствует хотя бы одно из требований.
Исходный файл QVW на локальном компьютере никогда не изменяется и не удаляется. После завершения загрузки данных удаляется только временная копия в Qlik Cloud.
Автоматическая загрузка двоичного файла не поддерживается для приложений, использующих Section Access. Механизм перезагрузки Qlik Cloud не может пройти аутентификацию в таблице Section Access в исходном файле QVW. Когда QV2QS обнаруживает Section Access в исходном приложении, шаги загрузки двоичного файла и перезагрузки пропускаются, а в журнал записывается предупреждение. Приложение развернуто без данных. Чтобы загрузить данные, создайте подключения к данным Qlik Cloud и обновите Скрипт загрузки вручную или удалите Section Access из копии исходного QVW и запустите повторно с --autoBinary.
Когда --preserveTargetAppScript объединяется с --reload, перезагрузка выполняет существующий Скрипт загрузки в целевом приложении, а не преобразованный скрипт. Это полезно, когда целевое приложение уже имеет работающие подключения к данным Qlik Cloud и требуется обновить только Слой пользовательского интерфейса. Подробнее см. Повторное использование существующего приложения.