Общие рабочие процессы
Последнее обновление: 14.10.2026Следующие примеры охватывают наиболее частые варианты использования. Каждый основан на одном и том же базовом шаблоне: укажите файл QVW, выходную папку и контекст Qlik Cloud. Во всех примерах --outputDir является корневым элементом вывода. QV2QS автоматически создает подпапку, названную по имени файла QVW (например, ./output/Sales/). Все эти рабочие процессы также могут быть выполнены с помощью веб-мастера. Для пошагового подхода см. Шаги мастера.
Развернуть в Qlik Cloud с данными
Стандартный рабочий процесс миграции. QV2QS генерирует папку PRJ, преобразует пользовательский интерфейс, загружает QVW для загрузки бинарных данных, перезагружает приложение в Qlik Cloud и формирует отчет Excel. Загруженный QVW удаляется, и исходный Скрипт загрузки восстанавливается после перезагрузки.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
Экспорт файла QVF
QV2QS создает приложение используя движок Qlik Cloud, экспортирует результат в виде файла QVF, затем удаляет облачное приложение. Экспортированный QVF может быть импортирован в другой клиент Qlik Cloud.
Импорт файлов QVF, сгенерированных QV2QS, в Qlik Sense Enterprise Client-Managed не тестируется во всех версиях, официально не поддерживается и не рекомендуется. Подробнее см. совместимость Qlik Sense Enterprise Client-Managed.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
Пакетная миграция всего комплекса QlikView
Сканировать одну или несколько папок на предмет всех пар QVW и PRJ, преобразовать пары параллельно и развернуть каждую в Qlik Cloud. Используйте --batchWorkers для управления параллелизмом.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
Сохранить пиксельный макет QlikView
Включите режим фиксированного холста, чтобы сохранить точные положения объектов QlikView и фоновые изображения листа. Отрегулируйте масштабные коэффициенты, чтобы контролировать, как макет сопоставляется с размерами экрана Qlik Sense.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
Обновить ранее преобразованное приложение
Повторно запустить преобразование для существующего приложения Qlik Cloud без создания нового. QV2QS переиспользует идентификатор приложения из предыдущего запуска.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
Обновить приложение, сохраняя его Скрипт загрузки
Повторно запустите преобразование, чтобы обновить Слой пользовательского интерфейса существующего приложения без перезаписи Скрипта загрузки. Целевое приложение сохраняет свои существующие подключения к данным и логику перезагрузки. Резервная копия без данных автоматически экспортируется перед обновлением. Добавьте --reload для выполнения существующего скрипта и обновления данных.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
Обновить приложение, сохраняя его переменные
Перезапустите преобразование, чтобы обновить Слой пользовательского интерфейса и Скрипт загрузки существующего приложения без перезаписи переменных. Объедините с --preserveTargetAppScript, чтобы сохранить нетронутыми как Скрипт загрузки, так и переменные из целевого приложения.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Настроить аутентификацию Qlik Cloud
Настройте контекст qlik-cli перед запуском любого преобразования. Интерактивная настройка запрашивает URL-адрес клиента и ключ API и сохраняет учетные данные для последующих запусков.
QV2QS.exe --setupQlikAuth
Программное использование (CI/CD)
QV2QS поддерживает прямую аутентификацию без предварительно созданных контекстов qlik-cli. Передайте URL-адрес клиента и ключ API встроенно. QV2QS проверяет учетные данные и внедряет заголовки аутентификации в каждый вызов qlik-cli. Файл контекста не создается и не изменяется. Используйте --accept-eula, чтобы принять лицензионное соглашение без интерактивного запроса.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
Этот режим безопасен для одновременного выполнения несколькими арендаторами и пользователями. Ключ API не записывается на диск и не отображается в файлах журнала.
Учетные данные также могут быть заданы как переменные среды:
set QV2QS_QLIK_TENANT_URL=https://my-tenant.us.qlikcloud.com
set QV2QS_QLIK_API_KEY=eyJhbG...
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --autoBinary --reload --plain
Локальная сборка без Qlik Cloud
Сгенерировать преобразованный результат и отчет о преобразовании на диск без подключения к Qlik Cloud. Режим только локального доступа предназначен для оценки миграции, предварительного обзора развертывания и автономных сред. Выходные данные локальной сборки не включают загрузки медиафайлов, разрешение фоновых изображений, создание альтернативных состояний или публикацию листа. Для полного развертывания используйте Build to Qlik Cloud или режим Export QVF. Подробнее об ограничениях и сценариях использования только локального режима см. Как работает преобразование.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly