参数参考

上次更新日期：2026/10/14

下表列出了按类别分组的所有可用参数。

输入和输出

批处理模式

Qlik Cloud

身份验证

布局和样式

有关固定画布和动态网格模式的详细说明，请参阅转换布局设置。

转化报告

控制台报告和Excel报告在CLI模式和用户和界面中默认情况下都已启用。

控制台和日志记录

QV2QS 支持四种控制台输出模式。

• 美观 — 具有颜色、动画微调器、进度条和主题面板的富格式输出。美观模式是交互式终端使用的默认设置。需要一个支持彩色的终端 (Windows 10+、PowerShell 5+ 或类 Unix shell)。
• 纯文本 — 带时间戳的文本输出，不含 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 应用启发式方法检测日期类字段名，并抑制这些字段上的基于状态的排序，使值保持其自然顺序，无论选择项状态如何。

启发式算法通过非字母数字字符和驼峰式大小写边界来分割每个字段名并进行分词（例如，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 显式禁用它。

这两个修复都仅适用于维度和度量表达式。不支持的功能发现不予修改。当修复被禁用时，已标记的模式将保留在表达式发现工作表中以供手动审查。

了解更多

• 常见工作流程
• 日志记录和诊断
• 布局模式