输出结构和应用程序命名
上次更新日期：2026/10/14QV2QS 将批量输出组织为目录层级结构，并为 Qlik Cloud 部署提供灵活的应用程序命名。本主题涵盖目录布局选项、设置建议和命名模板。
单项目模式还会在输出根目录下为每个项目创建一个子文件夹。有关详情，请参阅转换的工作原理。
输出结构
默认情况下，QV2QS 会在输出根目录下镜像源目录层级结构。每个项目都会生成一个包含构建输出、报告和日志的子文件夹。
保留层次结构（默认）
<outputDir>/
<RelativePath>/
<ProjectName>/
build/
images/
reports/
logs/
展平层级 (--batchFlatOutput)
<outputDir>/
<ProjectName>/
build/
images/
reports/
logs/
当源文件夹结构反映了组织分组（按部门、区域或业务单元），且输出需要与该结构保持一致时，保留层级结构非常有用。当文件夹结构没有实际意义，或者下游更易于处理扁平列表时，展平层级结构非常有用。
如果两个项目生成相同的输出文件夹名称（例如，不同子目录中两个名为 Sales 的项目），QV2QS 会追加 _2、_3 及后续数字以避免冲突。
批处理模式下的设置
所有转换设置均统一应用于批次中的每个项目。没有按项目覆盖的机制。固定画布缩放、对象缩放、尺寸约束、裁剪尺寸、布局收缩、背景处理以及所有其他设置，均完全相同地应用于运行中的每个应用程序。
这种统一应用具有重要的实际意义：在运行批量转换时，将相似的应用归为一组。具有相似屏幕分辨率、背景图像布局和对象尺寸的应用程序适合在单个批次中处理。布局或设计模式差异显著的应用程序适合使用不同的设置分别进行批处理运行。
批量转换的推荐工作流程：
- 将所有源 QVW 和 QVF 文件复制到本地工作文件夹。请勿对生产目录或网络共享执行批量转换。
- 识别具有类似布局特征（分辨率、背景图像、对象密度）的 QlikView 应用程序组。
- 在单项目模式下从每个组中加载一个代表性应用程序。
- 打开 Mockup Studio，尝试调整固定画布、缩放、裁剪和尺寸约束设置，直到布局令人满意为止。
- 记下为该组产生最佳效果的设置。
- 切换到批处理模式，指向包含该组的文件夹，并应用相同的设置。
- 对每组应用程序重复此操作。
这种方法避免了使用通用设置运行大批量任务、事后再花费时间逐个手动调整应用的常见错误。在 Mockup Studio 中使用代表性样本进行几分钟的测试，即可在大批量处理中节省大量工作。
先从 3 到 5 个应用程序的小批次开始验证设置，然后再扩展到完整集合。
批量模式下的应用命名
将批量转换部署到 Qlik Cloud 时，--qsAppName 控制每个应用程序的命名方式：
- 未指定 — 每个应用程序均以项目命名 (
<Name>)。 - 纯文本 — 该值用作前缀：
<prefix> - <Name>。 - 带占位符的模板 — 该值被视为格式字符串。
以下占位符可在模板字符串中使用。
| 占位符 | 描述 |
|---|---|
{name}
|
项目名称 |
{rel}
|
相对于扫描根目录的相对目录路径 |
{index}
|
项目序号（从 1 开始） |
例如，--qsAppName "Migrated {name} ({rel})" 会生成类似于 Migrated Sales (region1/finance) 的应用程序名称。