Как работает конверсия

Последнее обновление: 14.10.2026

Конвейер преобразования имеет следующие фазы:

Извлечь — Если --generatePrj включено, QV2QS запускает QlikView Desktop для извлечения файла QVW в папку PRJ. QV2QS использует встроенный портативный движок, если не обнаружена системная установка QlikView Desktop. Подробнее см. движок QlikView Desktop.
Парсинг — QV2QS считывает папку PRJ и анализирует каждое определение объекта, макет листа, Скрипт загрузки, переменную и свойство документа. QV2QS также напрямую считывает двоичный файл QVW/QVF для извлечения метаданных, переменных и любого скрытого Скрипта загрузки, встроенного в файл.
Преобразовать — Каждый объект QlikView сопоставляется с типом визуализации Qlik Sense. Измерения, меры, выражения, стили и позиции макета переводятся в формат JSON Qlik Sense.
Запись — QV2QS записывает преобразованную структуру приложения в выходную папку в виде набора JSON-файлов.
Развернуть (только в режимах облака) — QV2QS создает приложение на клиенте, загружает медиафайлы, собирает приложение и при необходимости перезагружает приложение с данными.
Отчет — QV2QS генерирует отчет о преобразовании, обобщающий результаты, оценку автоматизации и любые элементы, требующие ручного контроля.

Фаза развертывания выполняется в режимах сборки в Qlik Cloud и экспорта QVF. В режиме только локального доступа QV2QS записывает преобразованный вывод на диск без подключения к Qlik Cloud. Фаза формирования отчета выполняется во всех режимах.

Режимы преобразования

QV2QS поддерживает три режима преобразования. Выберите режим на шаге Настройка мастера или с соответствующим флагом CLI.

Режим	Флаг CLI	Qlik Cloud требуется	Выходные данные	Фаза развертывания
Сборка в Qlik Cloud	(по умолчанию)	Да	Приложение развернуто для клиента	Да — создает приложение, загружает медиа, собирает, публикует листы
Экспорт QVF	`--exportQvf`	Да	Файл QVF на диске	Да — создает приложение в Qlik Cloud, экспортирует как QVF, затем удаляет облачное приложение
Только локально	`--unbuildOnly`	Нет	Папка сборки и отчет о преобразовании на диске	Нет

Сборка в Qlik Cloud является рекомендуемым режимом для миграции. Экспорт QVF полезен для создания переносимого файла для обмена или импорта в другого клиента. Автономный режим предназначен для оценки и проверки. Подробную информацию об ограничениях только для локального использования см. в разделе ниже.

Пользовательский интерфейс по умолчанию использует режим фиксированного холста, перезагрузка включена и авто-бинарный режим включен. CLI по умолчанию использует динамический режим сетки, перезагрузка отключена, и авто-бинарный режим отключен. При переходе от мастера к CLI, укажите эти флаги явно, чтобы соответствовать поведению мастера. Полный список аргументов и значений по умолчанию см. в Argument reference.

Только локальный режим

Локальный режим (--unbuildOnly) выполняет фазы анализа, преобразования, записи и отчета без подключения к Qlik Cloud. Клиент или ключ API не требуются. QV2QS генерирует полный отчет о преобразовании, краткий обзор для руководства и папку выходных данных сборки на диске.

Сценарии использования

Оценка миграции — Запустите режим «Только локально» для создания отчета о преобразовании, сводного отчета, показателя автоматизации и результатов анализа выражений без необходимости доступа к Qlik Cloud. Оцените качество преобразования по всему комплексу QVW, прежде чем настраивать учетные данные клиента.
Проверка перед развертыванием — Проверьте сгенерированные выходные данные (Скрипт загрузки, определения объектов, переменные, измерения) перед тем, как приступить к облачному развертыванию. Организации с процессами управления изменениями могут просмотреть выходные данные как промежуточный артефакт.
Автономные или ограниченные среды — Когда машина, на которой размещены файлы QVW, не имеет исходящего доступа в интернет, запустите режим «Только локально», чтобы сгенерировать отчет о преобразовании локально. Чтобы развернуть преобразованное приложение, скопируйте файлы QVW на компьютер с доступом к Qlik Cloud и запустите QV2QS в режиме сборки для Qlik Cloud с подключенного компьютера.

Ограничения

Фаза развертывания выполняет несколько операций, которые qlik app build сама по себе не выполняет. Запуск режима только локально, а затем развертывание build/ папки вручную с помощью автономной qlik-cli установки приводит к следующим пробелам.

Медиафайлы не загружены. Фоновые изображения и изображения кнопок извлекаются в папку images/, но не включаются в папку build/. Команда qlik app build не обрабатывает медиафайлы. Все фоновые изображения и изображения кнопок будут отсутствовать в развернутом приложении.
Ссылки на фон листа и объекта не разрешены. QV2QS внедряет URL-адреса фоновых изображений в JSON-файлы листа и объектов во время фазы развертывания, используя идентификатор облачного приложения. Выходные данные локальной сборки не содержат ссылок на фоновые изображения. Листы и объекты не будут иметь фонов в развернутом приложении.
URL-адреса изображений кнопок содержат строки-заполнители. Изображения кнопок в выходных данных локальной сборки используют внутренние значения-заполнители вместо разрешенных URL-адресов медиафайлов. Движок Qlik Sense не может интерпретировать строки-заполнители. Изображения кнопок будут отображаться поврежденными.
Альтернативные состояния не созданы. Альтернативные имена состояний записываются в cloud/alternate_states.json за пределами build/ папки. Команда qlik app build не обрабатывает альтернативное состояние. Объекты, ссылающиеся на нестандартные состояния, могут отображаться некорректно.
Листы не опубликованы. Команда qlik app build создает листы как персональные объекты, видимые только владельцу приложения. QV2QS публикует листы как базовые листы во время фазы развертывания. В общем пространстве другие пользователи не увидят никаких листов, пока листы не будут опубликованы вручную.

Для полного развертывания, включающего загрузку медиафайлов, разрешение фоновых изображений, создание альтернативных состояний и публикацию листов, используйте режим «Сборка в Qlik Cloud» или режим «Экспорт QVF» вместо режима «Только локально».

Безопасность исходного файла

QV2QS не изменяет содержимое исходного файла QVW или QVF. На этапе извлечения QV2QS открывает исходный документ через QlikView Desktop и сохраняет временную копию в системную временную папку. QV2QS затем закрывает исходный и генерирует папку PRJ из временной копии. После завершения генерации PRJ, QV2QS копирует полученную -prj папку обратно в тот же каталог, что и исходный файл, и удаляет временную копию. Если -prj папка уже существует рядом с исходным файлом, QV2QS заменяет папку новой сгенерированной версией. Весь другой вывод преобразования записывается в отдельную выходную директорию, указанную --outputDir.

QlikView Desktop получает блокировку файла на исходном документе, пока создается временная копия. Запуск QV2QS для файла, который активно открыт в QlikView Desktop или обслуживается QlikView Server, может привести к конфликтам блокировки файлов или сбою при генерации PRJ. Файлы на общих сетевых дисках могут вызывать те же конфликты. Запись -prj папки обратно в сетевую папку или каталог только для чтения также может завершиться неудачей.

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

Скопируйте файлы QVW или QVF в локальную рабочую папку на компьютере, где запущен QV2QS.
Направьте QV2QS на скопированные файлы, а не на оригиналы.
Закройте все запущенные экземпляры QlikView Desktop перед началом преобразования. QV2QS требует исключительного доступа к QlikView Desktop.

Не запускайте QV2QS напрямую в отношении папок документов QlikView Server, общих сетевых ресурсов для производства или файлов, открытых в QlikView Desktop. Всегда используйте локальную копию исходных документов.

Типичное время

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

Фаза	Типичная продолжительность	Примечания
Выгрузка (генерация PRJ)	5–15 секунд	Зависит от сложности QVW. Пропущено, если папка PRJ уже существует.
Парсинг + Конвертация + Запись	Менее 30 секунд	Основное преобразование XML в JSON. Обрабатывает сложные приложения с сотнями объектов.
Развертывание (облачная сборка)	1–3 минуты	Включает создание приложения, загрузку медиа и сборку приложения для клиента.
Перезагрузить	Варьируется	Зависит от объема данных, задержки источника данных и ресурсов клиента. Загрузка двоичного файла типичного QVW завершается менее чем за минуту.

Преобразование одного приложения с развертыванием в облаке и перезагрузкой данных обычно завершается за две-пять минут от начала до конца. Только локальные преобразования (--unbuildOnly) завершаются менее чем за 30 секунд.

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

Структура выходной папки

Аргумент --outputDir указывает корневой каталог вывода. QV2QS создает подпапку, названную по имени файла QVW (или папки PRJ), внутри корневого каталога вывода. Все результаты преобразования для проекта записываются в эту подпапку. Если два файла QVW имеют одинаковое имя, QV2QS добавляет _2, _3 и последующие числа, чтобы избежать конфликтов. Такое поведение соответствует пакетному режиму, где каждый проект также получает выделенную подпапку.

<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/
    cloud/
    qvf/

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

Папка / файл	Содержание
`build/`	Структура приложения Qlik Sense для `qlik app build`. Содержит `config.yml` (манифест сборки), `script.qvs` (Скрипт загрузки), `app-properties.json`, `connections.yml` (подключения к данным), `dimensions.json` (основные измерения), `measures.json` (основные меры), `variables.json`, и подпапку `objects/` с одним JSON-файлом на каждый лист и визуализацию.
`images/`	Извлеченные медиафайлы (дедуплицированные по хешу содержимого) и `backgrounds.json` (фоновый манифест).
`reports/`	`executive_summary.json`, `executive_summary.html`, а также отчет о преобразовании Excel (`_conversion_report_.xlsx`) если включено.
`logs/`	Структурированные файлы журнала для каждого запуска.
`cloud/`	`cloud_state.json` (ID приложения, хеш медиа, сопоставление ID листа, Метка времени) и `alternate_states.json`. Создано во время облачного развертывания.
`qvf/`	Экспортированные QVF-файлы (созданные, когда `--exportQvf` используется).
`.qv2qs_source`	Файл-маркер, который фиксирует, какой QVW создал подпапку. QV2QS использует маркер для обнаружения конфликтов имен и для повторного использования правильной папки при последующих запусках.

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

После преобразования

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

Исправить перед публикацией

Откройте отчет о преобразовании Excel в reports/ подпапке и просмотрите лист Объекты_для_последующего_контроля. Сначала исправьте все элементы, помеченные как Ошибка (объекты, которые не удалось преобразовать), затем Заполнитель (объекты, которые требуют перестройки), затем Требуется корректировка (объекты, которые были преобразованы частично).
Просмотрите результаты анализа на листе Анализ, включая ссылки на макросы, использование Section Access и шаблоны Скрипта загрузки, которые могут потребовать ручного внимания.
Убедитесь, что выражения вычисляются правильно. QV2QS автоматически исправляет проблемы с цитированием в анализе множеств при преобразовании. Просмотрите вычисляемые измерения, условное форматирование и выражения, использующие функции, доступные только в QlikView (GetCurrentField(), MsgBox()), которые требуют ручного переписывания.
Проверьте Overflow_Actions рабочий лист на предмет объектов, в которых избыточные измерения или показатели были перемещены в коллекцию альтернатив.

Проверить перед публикацией

Откройте преобразованное приложение в Qlik Sense и убедитесь, что макеты листов, положения объектов и фоновые изображения отображаются должным образом.
Убедитесь, что навигация по вкладкам контейнера (полосы кнопок или контейнеры с вкладками) правильно переключается между областями содержимого.
Проверьте детализацию и поведение переключения Циклической группы на диаграммах, которые используют группы измерений.
Убедитесь, что условия отображения скрывают и показывают объекты как ожидалось.
Проверьте порядок сортировки в списках и таблицах, особенно для полей типа "дата".

Польский

Настройте шрифты, цвета или расположение объектов в редакторе приложения Qlik Sense по мере необходимости. Для получения рекомендаций по позиционированию макета, см. Настройки макета преобразования.

Для полного описания содержимого отчета см. Отчет о конверсиях.

Узнать больше

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

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

Оставьте свой отзыв здесь