Ссылка на аргумент

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

Таблицы ниже перечисляют все доступные аргументы, сгруппированные по категориям.

Ввод и вывод

Пакетный режим

Qlik Cloud

Проверка подлинности

Разметка и стили

Для подробного объяснения режимов фиксированного холста и динамической сетки см. Настройки макета преобразования.

Отчет о конверсии

Консольный отчет и отчет Excel оба включены по умолчанию в режиме CLI и в пользовательском интерфейсе.

Консоль и ведение журнала

QV2QS поддерживает четыре режима вывода консоли.

• Красивый — Вывод с расширенным форматированием, включающий цвета, анимированные спиннеры, индикаторы выполнения и тематические панели. Режим Pretty используется по умолчанию для интерактивного использования терминала. Требуется терминал с поддержкой цвета (Windows 10+, PowerShell 5+ или Unix-подобные оболочки).
• Простой — Текстовый вывод с метками времени без управляющих последовательностей ANSI. Каждая строка предваряется отметкой времени и тегом фазы в формате [MM:SS] [phase] message. Заголовки и таблицы используют символы ASCII. Подходит для конвейеров CI/CD, файлов журналов и терминалов, которые не поддерживают форматирование ANSI.
• Без вывода — Подавляет весь стандартный вывод. Отображаются только ошибки. Подходит для автоматизированной пакетной обработки и сценарных рабочих процессов, где не требуется вывод в консоль.
• UI — Строково-ориентированный вывод без временных меток или кодов ANSI. Пользовательский интерфейс устанавливает этот режим автоматически при запуске подпроцесса преобразования. Формат оптимизирован для встроенного средства просмотра журнала. Запуск --console ui из терминала дает читаемый, но неформатированный вывод; используйте --plain или --console pretty вместо этого для непосредственного использования в терминале.

Флаги --dark и --light выбирают цветовую тему. Темная тема (по умолчанию) использует глубокую темно-синюю палитру, вдохновленную Qlik. Светлая тема использует светло-серую палитру. Флаг --surface включает тонкую фоновую заливку за каждой строкой вывода. Заливка поверхности включена по умолчанию в режиме красивого отображения. Используйте --noSurface, чтобы отключить заливку фона.

В режиме одного проекта файлы журналов записываются в %LOCALAPPDATA%\QV2QS\logs\ по умолчанию. В пакетном режиме файлы журнала записываются в logs/ подпапку в выходном каталоге. Переопределить Местоположение с помощью --logDir. Настройте --logLevel DEBUG для захвата подробного диагностического вывода для устранения проблем с преобразованием. Используйте --cleanLogs для удаления файлов журнала старше 30 дней перед каждым запуском. Для полного описания расположения файлов журнала, их ротации и формата см. Ведение журнала и диагностика.

Загрузить скрипт

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

Каждое правило использует двухэтапный процесс сопоставления. Поле pattern является регулярным выражением, которое выбирает область Скрипта загрузки. Поле search затем применяется только в каждой соответствующей области. Этот подход предотвращает непреднамеренные замены вне целевого контекста.

Этот --scriptReplacements аргумент принимает файл JSON, который становится единственным источником достоверной информации для всех правил замены. При предоставлении файла встроенные значения по умолчанию не загружаются автоматически. Чтобы включить встроенные правила наряду с пользовательскими правилами, экспортируйте полный набор правил из мастера и отредактируйте экспортированный файл. Правила выполняются в execution_order порядке.

Доступны три поведения CLI:

• Без флага — восемь встроенных правил выполняются.
• --scriptReplacements <file> — выполняются только правила, указанные в файле. Встроенные значения по умолчанию не загружаются автоматически.
• --noScriptReplacements — правила не выполняются.

Файл --scriptReplacements представляет собой массив JSON из объектов правил:

[
  {
    "description": "Replace server path with lib connection",
    "pattern": "FROM\\s+'[^']*'",
    "search": "\\\\\\\\server\\\\share\\\\",
    "replace": "lib://DataFiles/",
    "is_regex": true,
    "case_sensitive": false,
    "enabled": true,
    "execution_order": 1
  }
]

Каждое правило имеет следующие поля:

Прочее

Защита сортировки поля даты

По умолчанию, Qlik Sense сортирует выбранные значения в начало списка. Для полей типа даты, таких как Квартал, Месяц или Год, эта перегруппировка нарушает ожидаемую хронологическую последовательность. QV2QS применяет эвристику для обнаружения имен полей, похожих на даты, и подавления сортировки на основе состояния для этих полей, сохраняя значения в их естественном порядке независимо от состояния выборок.

Эвристика токенизирует каждое имя поля, разделяя его по небуквенно-цифровым символам и границам camelCase (например, OrderDate становится order и date). Все токены приведены к нижнему регистру. Поле совпадает, если любой токен равен одному из следующих: date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar. Поле также совпадает, если любой токен заканчивается на date, month, или year (например, OrderDate, FiscalMonth). Токены update, candidate, и validate исключены во избежание ложных срабатываний. Сопоставление нечувствительно к регистру и использует только английские токены. Неанглоязычные названия полей (например, Monat или Fecha) не обнаруживаются.

У полей, соответствующих эвристике, удалена сортировка по состоянию и отключена автоматическая сортировка.

Используйте --disableDateStateStickySort, чтобы отключить эту эвристику. Когда отключено, все поля списка используют поведение сортировки Qlik Sense по умолчанию, включая переупорядочивание на основе состояния.

Исправления цитирования в анализе набора

QlikView и Qlik Sense по-разному интерпретируют кавычки в модификаторах анализа множеств. QV2QS применяет два независимых исправления при преобразовании. Исправление поиска по запросам в одинарных кавычках включено по умолчанию. Исправление для значений набора без кавычек Экспериментально и отключено по умолчанию.

Исправить значения поиска в одинарных кавычках (--fixSingleQuotedSearch)

Значения в одинарных кавычках, содержащие синтаксис поиска, преобразуются в двойные кавычки. Обнаруженные шаблоны поиска включают подстановочные знаки (*, ?, ^), операторы сравнения (>, >=, <, <=), нечеткий поиск (~), поиск по выражению (=), модификаторы поиска (+, -), и составной поиск ((…|…), (…&…)):

• {<Year={'2*'}>} становится {<Year={"2*"}>}
• {<Amount={'>100'}>} становится {<Amount={">100"}>}
• {<Customer={'~company'}>} становится {<Customer={"~company"}>}

Литералы обычного текста в одинарных кавычках (например, 'USA') и значения в одинарных кавычках в числовых полях не затрагиваются. Используйте --noFixSingleQuotedSearch, чтобы отключить это исправление.

Исправление незаключенных в кавычки установленных значений (--fixUnquotedSetValues) — Экспериментальный

Некавычкованные строковые значения заключаются в одинарные кавычки:

• {<Country={USA}>} становится {<Country={'USA'}>}

Числовые значения (2024), переменные со знаком доллара ($(vYear)), и строки в двойных кавычках остаются без изменений. Этот исправление выключено по умолчанию. Передайте --fixUnquotedSetValues, чтобы включить его. Используйте --noFixUnquotedSetValues, чтобы явно отключить его.

Оба исправления применяются только к выражениям измерения и меры. Результаты обнаружения неподдерживаемых функций не изменяются. Когда исправление отключено, помеченные шаблоны остаются для ручной проверки в рабочем листе Expression_Findings.

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

• Типовые рабочие процессы
• Журналирование и диагностика
• Режимы макета