# 系统要求

QV2QS 以单个 Windows 可执行文件的形式分发。没有安装程序，没有运行时依赖项，并且不需要服务器基础设施。

## 支持的操作系统

* Windows 10、11 或 Windows Server 2019、2022、2025

## 支持的浏览器

用户界面需要现代浏览器。支持以下浏览器：

* 谷歌浏览器
* Microsoft Edge
* Mozilla 火狐

Internet Explorer 不受支持。QV2QS 在启动时检测默认浏览器。如果默认浏览器是 Internet Explorer，QV2QS 将转而打开 Chrome、Edge 或 Firefox。如果未安装受支持的浏览器，控制台会显示下载链接。如果 Internet Explorer 直接访问用户界面，将显示一个页面，提示用户安装受支持的浏览器。

信息注释

在 Windows Server 2019 上，Internet Explorer 是唯一默认安装的浏览器。在以向导模式运行 QV2QS 之前，请先安装 Chrome 或 Edge。在 Windows Server 2022（已完全修补）和 Windows Server 2025 上，Edge 可用或可单独安装。

## 硬件建议

QV2QS 通过捆绑的 QlikView Desktop 引擎读取 QlikView 文档，并将其提取的元数据转换为 Qlik Sense 格式。QV2QS 不会将完整的 QVW 文件加载到其自身的进程内存中。捆绑的 QlikView Desktop 引擎打开文档并提取应用程序结构，QV2QS 读取生成的 PRJ 文件夹（小型 XML 和文本文件）。

| 资源 | 单一项目 | 批处理模式 |
| --- | --- | --- |
| CPU | 最低：2 核 | 推荐 4 核心 |
| RAM | 最小 4 GB。 | 8 GB 推荐 |
| 磁盘 | 与 QVW 文件大小成比例的可用空间，用于临时 PRJ 提取 | 所有并发 PRJ 提取以及输出文件所需的可用空间 |

在批处理模式下，每个并行工作器一次处理一个项目。默认工作进程数会基于 CPU 核心数自动检测（核心数减 1）。减少 `--batchWorkers` 在内存有限的机器上的使用。

## QlikView 文档格式

QV2QS 需要一个 QlikView 文档作为输入 — 一个 `.qvw` 文件或一个 `.qvf` 文件，该文件由 QlikView 12.70 或更高版本创建 — 可选地附带一个 PRJ 文件夹。QV2QS 可以根据源文件自动生成 PRJ 文件夹。

QlikView 12.60 及更早版本将文档保存为 `.qvw`。QlikView 12.70 (2022 年 5 月) 将默认保存格式更改为 `.qvf`，适用于新建文件。现有`.qvw`文件将继续保存为`.qvw`。这两种文件扩展名都包含一个 QlikView 文档，并且 QV2QS 都支持这两种格式。这些 QlikView 生成的 `.qvf` 文件不同于 Qlik Sense 导出的 `.qvf` 文件 — QV2QS 仅接受 QlikView 文档作为输入。要恢复 QlikView 默认设置，请在 `Settings.ini` 中设置 `QvDefaultFileFormat=qvw`。

PRJ 文件夹是一组 QlikView 在文档旁边创建的文本文件，当源文件旁边存在名为 `<DocumentName>-prj` 的文件夹时。PRJ 文件夹包含每个工作表、对象、变量、加载脚本、宏模块和文档属性的单独文件。QV2QS 读取这些文件，以提取 QlikView 应用程序的每个详细信息，而无需加载二进制文档。有关 PRJ 文件夹内容的完整说明，请参阅 [QlikView 项目文件](https://help.qlik.com/en-US/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/QlikView_Project_Files.htm)，位于 QlikView 文档中。

## 网络要求

构建到 Qlik Cloud 和导出 QVF 模式需要出站 HTTPS 访问到 Qlik Cloud 租户 URL。QV2QS 目前不支持 HTTP 代理服务器。如果网络需要代理才能进行出站 HTTPS 流量，请将 QVW 文件复制到可以直接访问 Qlik Cloud 的计算机上，并从已连接的计算机以“构建到 Qlik Cloud”模式运行 QV2QS。或者，使用仅限本地模式生成转换报告，用于评估目的。有关仅限本地限制的详细信息，请参阅[转换的工作原理](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#local-only-mode)。

## Qlik Cloud 要求

构建到 Qlik Cloud 和导出 QVF 模式需要一个 Qlik Cloud 租户和一个 API 密钥。租户管理员必须启用 API 密钥生成并分配所需的角色，然后用户才能连接。需要两个角色：

* 具有 管理 API 密钥 权限的自定义角色 — 启用 API 密钥生成。
* 私人分析内容创建者 角色 — 允许在个人空间中创建应用程序。

有关完整的租户设置过程，请参阅[设置 Qlik Cloud 访问](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm)。

分配角色后，从 Qlik Cloud 中的个人资料 &gt; API 密钥生成 API 密钥。复制并安全地存储密钥 — 该密钥仅显示一次。有关身份验证设置选项，请参阅[身份验证](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/authentication.htm)。

信息注释

Build to Qlik Cloud 和 Export QVF 两种工作流都使用 Qlik Cloud 引擎来创建和构建应用程序。只有仅限本地模式不需要云访问。有关详细信息，请参阅[向导步骤](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/user-interface/wizard-steps.htm)。

## 了解更多

* [QlikView 桌面引擎](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/qlikview-desktop-engine.htm)
* [设置 Qlik Cloud 访问](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm)
* [快速入门](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/quick-start.htm)