Шаги мастера
Последнее обновление: 14.10.2026Пользовательский интерфейс представляет собой мастер-интерфейс для полного процесса конвертации. Мастер открывается в браузере по умолчанию после двойного щелчка QV2QS.exe или запуска исполняемого файла с --ui флагом. Текущий номер версии отображается в диалоговом окне «О программе». Кнопка переключения темы в правом верхнем углу переключает между светлым и темным режимами. Дополнительные сведения см. в разделе Темный режим.
Мастер представляет следующие шаги по порядку. Шаги, которые не применимы к выбранному режиму рабочего процесса, скрываются автоматически.
Настройка
Выберите режим рабочего процесса (обязательно). Выбранный режим определяет, какие последующие шаги доступны.
- Сборка в Qlik Cloud (по умолчанию) — преобразует пользовательский интерфейс QlikView и развертывает получившееся приложение непосредственно в клиент Qlik Cloud. Выберите этот режим, чтобы увидеть преобразованное приложение в Qlik Cloud немедленно. Этот режим является рекомендуемым рабочим процессом для миграции.
- Экспорт QVF — преобразует пользовательский интерфейс QlikView с помощью механизма Qlik Cloud, экспортирует полученное приложение в виде файла QVF, затем удаляет облачное приложение. Выберите этот режим, чтобы создать файл для обмена с другой командой или импорта в другого клиента. Этот режим по-прежнему требует клиента Qlik Cloud и ключ API. Импорт в Qlik Sense Enterprise Client-Managed не тестируется на всех версиях и официально не поддерживается. Подробнее см. совместимость Qlik Sense Enterprise Client-Managed.
- Только локально — выполняет преобразование на диске без подключения к Qlik Cloud. Клиент Qlik Cloud или ключ API не требуются. Локальный режим генерирует полный отчет о преобразовании и выходные данные сборки для оценки, проверки или использования в автономном режиме. Выходные данные локальной сборки не включают загрузку медиафайлов, разрешение фоновых изображений, создание альтернативных состояний или публикацию листов — эти операции требуют фазы развертывания. Для полного развертывания, используйте Build to Qlik Cloud или режим Export QVF. Для получения подробной информации об ограничениях только для локального использования, см. Как работает преобразование. Нацеливание на QSECM с выходными данными сборки не тестируется во всех версиях и не поддерживается официально. Подробнее см. совместимость Qlik Sense Enterprise Client-Managed.
Проект
Настройте источник входных данных. Выполните одно из следующих действий:
- Один проект (по умолчанию): предоставьте файл QVW (обязательно). Автоматическое создание PRJ включено по умолчанию и автоматически создает папку PRJ из файла QVW. Отключите эту опцию, чтобы предоставить папку PRJ или ZIP вручную. Нажмите Попробовать пример, чтобы загрузить встроенный пример проекта без просмотра. Кнопка видна только тогда, когда поле QVW пусто. См. Примеры проектов.
- Пакет: укажите одну или несколько папок для сканирования (обязательно). QV2QS обнаруживает все соответствующие пары QVW и PRJ рекурсивно. Нажмите Попробовать пример, чтобы заполнить поле папки папкой с прилагаемыми примерами. Пакетные обработчики определяют, сколько преобразований выполняется параллельно (по умолчанию: автоматическое определение на основе ядер ЦП). Подробнее см. в разделе Пакетное преобразование.
Всегда указывайте QV2QS на копии исходных документов в локальной рабочей папке, а не на рабочие файлы на QlikView Server или общих сетевых дисках. Движок QlikView Desktop получает блокировку файла во время генерации PRJ, что может конфликтовать с активными сеансами QlikView. Подробнее см. Безопасность исходного файла.
Выходные данные
Задайте корневую папку вывода (обязательно). QV2QS автоматически создает подпапку, названную по имени проекта, внутри корневой папки вывода (например, <outputDir>/Sales/). Если два проекта имеют одинаковое имя, суффикс _2, _3 добавляется для предотвращения конфликтов. Включить Очистка журналов для удаления существующих файлов журнала перед запуском.
Аутентификация Qlik Cloud
Этот шаг появляется только в режимах Build to Qlik Cloud и Export QVF.
Выберите или создайте контекст qlik-cli для аутентификации с клиентом Qlik Cloud (обязательно). Создайте новый контекст, предоставив URL-адрес клиента и ключ API. Мастер проверяет подключение, прежде чем продолжить.
Qlik Cloud приложение
Этот шаг появляется только в режимах Build to Qlik Cloud и Export QVF.
| Параметр | Описание | По умолчанию |
|---|---|---|
| Название приложения | Имя для приложения Qlik Sense в Qlik Cloud | Имя файла QVW, имя папки PRJ или имя выходной папки |
| Перезагрузить | Перезагрузите приложение после сборки, чтобы выполнить Скрипт загрузки | Вкл |
| Автобинарный | Временно загрузите файл QVW для загрузки бинарных данных, затем удалите файл после перезагрузки. Требуется Перезагрузка. | Вкл |
| Бинарный AppId | Используйте существующее приложение QVW или QVF в Qlik Cloud для Загрузки двоичного файла вместо загрузки. Требуется Перезагрузка. Нажмите кнопку обзора, чтобы открыть средство выбора QVW. | — |
| Повторно использовать существующее приложение | Обновите ранее созданное приложение вместо создания нового. При включении QV2QS проверяет выходную папку на наличие предыдущего развертывания, соответствующего выбранному файлу QVW, и автоматически заполняет идентификатор приложения. Если предыдущее развертывание не найдено, введите идентификатор приложения вручную или нажмите кнопку обзора, чтобы открыть средство выбора QVF. | Выкл. |
| Сохранить Скрипт загрузки | Сохраните существующий Скрипт загрузки в целевом приложении. Преобразованный скрипт не применен. Требуется Повторное использование существующего приложения. Отключает Перезагрузку по умолчанию; повторно включите, чтобы выполнить существующий скрипт. | Выкл. |
| Сохранить переменные | Сохраните существующие переменные в целевом приложении. Преобразованные переменные не применяются. Требуется Повторное использование существующего приложения. | Выкл. |
| Пропустить резервное копирование до развертывания | Не экспортируйте резервную копию QVF перед перезаписью приложения. По умолчанию, резервная копия без данных сохраняется в cloud/backups/. Требуется Повторное использование существующего приложения. |
Выкл. |
| Опубликовать листы | Опубликовать все преобразованные листы как базовые листы после сборки. Базовые листы видны каждому пользователю, который имеет доступ к приложению. Отключите эту настройку, чтобы листы оставались личными (неопубликованными) объектами. Когда Повторное использование существующего приложения включено, настройка применяется только к новым листам. Ранее опубликованные листы восстанавливаются автоматически независимо от этой настройки. | Вкл |
| Сборка без данных | Пропустить загрузку данных на этапе сборки. Приложение собирается на клиенте без данных, что позволяет тестировать структуру пользовательского интерфейса без ожидания перезагрузки. | Выкл. |
| Экспортировать без данных | Удалить данные из экспортированного файла QVF. Приложение в облаке может по-прежнему содержать данные из сборки, но загруженный QVF меньше. Экспорт только в режиме QVF. | Выкл. |
Поля Двоичный идентификатор приложения и Использовать существующее приложение содержат кнопки обзора, которые открывают модальные окна выбора облачного приложения. Каждый выборщик загружает приложения из подключенного клиента с фильтрацией по имени, владельцу, пространству или ID приложения. Средство выбора QVW также предоставляет фильтр по типу приложения (QVW, QVF или все). Выберите приложение из списка, чтобы автоматически заполнить поле.
Корректировки выражений
| Параметр | Описание | По умолчанию |
|---|---|---|
| Исправить значения поиска в одинарных кавычках | Преобразуйте шаблоны с одинарными кавычками и сравнения в двойные кавычки в выражениях анализа множеств. Подробнее см. Справочник аргументов. | Вкл |
| Исправить незаключенные в кавычки установленные значения (Экспериментальный) | Заключайте строковые значения без кавычек в одинарные кавычки в выражениях анализа множеств. Подробнее см. Справочник аргументов. | Выкл. |
Стиль
Следующие настройки управляют внешним видом листа и поведением макета.
Тема
| Параметр | Описание | По умолчанию |
|---|---|---|
| Тема приложения | Тема Qlik Sense применена к преобразованному приложению. Раскрывающийся список перечисляет четыре встроенные темы Qlik. Когда настроен контекст Qlik Cloud, нажмите кнопку обновления, чтобы получить пользовательские темы, установленные на клиенте. Sense Classic обеспечивает наивысшую точность соответствия 1:1 с QlikView. Неклассические темы могут изменять границы объектов, цвета фона, шрифты и отступы. Тема устанавливает только значение по умолчанию; пользователи могут переключать темы в любое время в клиенте Qlik Sense. | Sense Классический |
Фоны
| Параметр | Описание | По умолчанию |
|---|---|---|
| Фоновые изображения листа | Извлечение и применение фоновых изображений листов QlikView | Вкл |
| Возврат к фону документа | Использовать фоновый рисунок уровня документа для листов, у которых его нет | Вкл |
| Переопределение цвета фона | Сплошная заливка применена ко всем листам (#RRGGBB) |
— |
Макет
| Параметр | Описание | По умолчанию |
|---|---|---|
| Показать заголовок листа | Добавить область заголовка к преобразованным листам | Выкл. |
| Пропускать скрытые листы | Исключить листы с постоянно ложными условиями отображения | Выкл. |
Поля со списками и сортировка
| Параметр | Описание | По умолчанию |
|---|---|---|
| Сохранить цвета списков QV | Применить оригинальные цвета фона и прозрачность полей списка QlikView | Вкл |
| Защита сортировки поля даты | Сохраняйте поля списка, похожие на даты (Год, Квартал, Месяц и подобные), отсортированными хронологически вместо по состояниям выборок. Подробнее см. Справочник аргументов. | Вкл |
Расширенный
| Параметр | Описание | По умолчанию |
|---|---|---|
| Фиксированный холст листа | Включить позиционирование в стиле QlikView с точностью до пикселя. Отображает коэффициенты масштабирования, минимальные размеры и параметры обрезки холста. Масштаб холста и масштаб объекта связаны по умолчанию; нажмите на значок цепочки, чтобы установить независимые значения. Дополнительные сведения см. в разделе Настройки макета преобразования. | Вкл |
| Автоматическое расширение динамического листа | Разрешить листам расти вертикально за пределы стандартной высоты сетки | Вкл |
| Обработчики загрузки медиа | Количество параллельных рабочих процессов для загрузки медиафайлов (обоев и изображений) в Qlik Cloud. Применимо к сборке в Qlik Cloud и режимам экспорта QVF. | 2
|
| Замены скриптов | Включить или выключить обработку замены скриптов и управлять отдельными правилами. Подробнее см. Справочник аргументов. | Вкл |
Раздел замены скриптов включает встроенный редактор правил. Переключите главный переключатель, чтобы включить или отключить всю обработку скриптов. Разверните раздел, чтобы просмотреть, добавить, изменить или удалить отдельные правила. Каждое правило можно включить или выключить независимо. Нажмите Сбросить до значений по умолчанию, чтобы восстановить восемь встроенных правил. Значок сводки показывает количество включенных правил.
Нажмите кнопки со стрелками вверх и вниз на правиле, чтобы изменить порядок выполнения. Правила с более низким порядком выполнения запускаются первыми. Нажмите Экспорт, чтобы загрузить все правила в виде файла JSON. Нажмите Импорт, чтобы загрузить правила из файла JSON, заменив текущий набор. Импортированные файлы должны содержать JSON-массив, где каждое правило имеет description, pattern, и search поле.
Чтобы создать пользовательский файл правил для импорта, сначала нажмите Экспорт, чтобы получить встроенные правила в правильном формате. Отредактируйте экспортированный файл, чтобы добавить, удалить или изменить правила, затем нажмите Импорт, чтобы загрузить обновленный набор.
Когда настроены пользовательские правила или отключенные значения по умолчанию, предварительный просмотр команды отображает уведомление. Скопированная команда не включает пользовательские правила. Экспортируйте правила в файл JSON и добавьте --scriptReplacements <path> в команду, чтобы включить пользовательские правила в командной строке.
Для объяснения того, как работают правила, включая двухэтапный процесс сопоставления и встроенный список правил, см. Справочник по аргументам.
Откройте Mockup Studio с шага «Дополнительно», чтобы интерактивно просмотреть макеты с фиксированным холстом и динамической сеткой, настроить масштабирование и применить параметры обратно в мастер.
Отчет о конверсии
Следующие настройки управляют выходным файлом отчета преобразования.
| Параметр | Описание | По умолчанию |
|---|---|---|
| Сформировать отчет | Сформировать консольный отчет о преобразовании | Вкл |
| Отчет Excel | Экспортировать отчет как файл XLSX с детализацией по объектам и оценкой автоматизации. Введите имя файла (например, MyReport) или полный путь. Расширение .xlsx добавляется автоматически. Оставьте пустым для автоматического именования в reports/. |
Вкл |
| Включить выделения и объекты поиска | Включить блок Текущие выборки и объект Поиск в отчет. Они добавляются автоматически с помощью Qlik Sense и исключены по умолчанию. | Выкл. |
Обзор
Подтвердите все настройки перед запуском. Этап проверки отображает сводные карточки для конфигурации проекта, рабочего процесса, облака и вывода. В пакетном режиме в таблице перечислены все обнаруженные проекты.
Контрольный список обязательных действий на боковой панели отслеживает пункты, которые должны быть настроены перед запуском. Элементы сгруппированы по категории: рабочий процесс, входные данные, выходные данные и аутентификация в облаке. Каждый элемент показывает ОК, когда настроен, или НЕ ЗАДАНО, когда значение отсутствует. Нажмите на элемент, чтобы перейти непосредственно к соответствующему шагу мастера.
Панель предварительного просмотра команды отображает эквивалентную команду CLI для текущей конфигурации мастера. Переключение между синтаксисом PowerShell и Bash. Щелкните Копировать, чтобы скопировать команду в буфер обмена. Предварительный просмотр команды полезен для изучения аргументов CLI или сохранения точной команды для повторных запусков по сценарию.
Нажмите Выполнить, чтобы начать преобразование.
Запустить
Отображает вывод консоли в реальном времени по мере выполнения преобразования. Остановить запущенное преобразование, следить за журналами в реальном времени и открыть выходную папку или приложение Qlik Cloud, когда выполнение завершится.