将报表模板从 Qlik NPrinting 导出到 Qlik Cloud | 迁移中心帮助
跳到主要内容 跳到补充内容

将报表模板从 Qlik NPrinting 导出到 Qlik Cloud

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

该 Qlik NPrinting 导出功能可转换连接到 Qlik Sense Enterprise on Windows 应用程序的报告模板。此转换后的报表格式可以与您的 Qlik Sense 应用程序一起导入 Qlik Cloud。

以下 Qlik NPrinting 版本支持导出报表以在 Qlik Cloud 中使用:

  • Qlik NPrinting 2024 年 2 月:支持导出 Excel 模板

  • Qlik NPrinting 2025 年 2 月 IR:支持导出 Excel 和 PixelPerfect 两种模板

  • Qlik NPrinting 2025 年 2 月 SR3:支持导出 Excel、PixelPerfect 和 HTML 模板

  • Qlik NPrinting 2026 年 5 月:支持导出 Excel、PixelPerfect、HTML、Word 和 PowerPoint 模板。

已迁移的 Excel、Word 和 PowerPoint 报告模板可以在 Microsoft Excel 的 Qlik 加载项中编辑,并使用 Qlik Cloud 进行分发。迁移后的 PixelPerfect 和 HTML 报表模板可以在 Qlik Cloud 界面中进行编辑,并使用 Qlik Cloud 进行分发。

用户可以导出 模板:

  • 在 Qlik NPrinting web 控制台 中:您可以导出所有连接到特定 Qlik Sense 应用程序的 Excel、PixelPerfect、HTML、Word 和 PowerPoint 报表模板。

  • 使用 NPrinting API:您可以选择导出 Qlik NPrinting 应用程序或针对特定选择的所有报表。

video thumbnail

先决条件

要将报表模板从 Qlik NPrinting 迁移到 Qlik Cloud ,您将需要:

  • 使用具有导出报表权限的用户所具备的 Qlik NPrinting web 控制台 访问权限。

  • 一个 Qlik Sense 应用程序,它:

    • 最初在中 Qlik Sense Client-Managed 创建,并连接到 Qlik NPrinting。

    • 已迁移到您的 Qlik Cloud 租户。您将需要应用程序的新 URL。有关迁移 Qlik Sense 应用程序的信息,请参阅 Qlik Analytics Migration Tool 概览。

      信息注释一旦将 Qlik Sense 应用程序上传到 Qlik Cloud 后,请勿编辑仍在 Qlik Sense Client-Managed 中的版本。对应用程序的一个版本所做的更改不会显示在另一个版本中。
  • 一个或多个 Qlik NPrinting 报表模板,格式为 Excel、Word、PowerPoint、PixelPerfect,或HTML格式,其中包含来自 Qlik NPrinting 连接到 Qlik Sense Client-Managed 的对象。包含不支持的功能的报表将不会添加到导出的文件中。要能够导出模板,您需要在 Qlik NPrinting 中编辑模板并删除不支持的功能。不支持以下内容:

    • 连接到 QlikView 文档的报表。

    • 连接到多个 Qlik Sense 应用程序的报表。

信息注释导出的报表文件将包含 Qlik NPrinting 中模板文件中的设置。Qlik NPrinting 报表设置(如动态命名、循环和过滤器)不由 Qlik Cloud 导入。

Qlik NPrinting 模板格式支持

Qlik NPrinting 支持将包含宏的 Office 格式(XLSM、DOCM、PPTM)用作模板文件,通过自定义模板实现。所有模板将转换为不支持宏的格式 (XLSX、DOCX、PPTX),以便导入到 Qlik Cloud。

警告注释出于安全原因,带有宏的 Office 文件 (XLSM、DOCM、PPTM) 将被转换为 XLSX、DOCX 或 PPTX,并且宏将被移除。

Qlik NPrinting 2024 年 2 月仅导出 Excel 模板文件。Qlik NPrinting 2025 年 2 月导出 Excel 和 PixelPerfect 文件。Qlik NPrinting 2025 年 2 月新增 HTML 文件导出功能。 Qlik NPrinting 2026 年 5 月新增 Word 和 PowerPoint 文件的导出功能。

出于安全原因,如果 PixelPerfect 模板包含脚本,当模板上传到 Qlik Cloud 时,这些脚本将被移除。脚本功能将不再可用。

信息注释将模板文件上传至 Qlik Cloud 时,HTML 模板将进行清理。出于安全原因,脚本、SVG 元素及样式元素将被删除或修改。上传之后,请务必使用集成在 Qlik Cloud 界面中的编辑器验证 HTML 内容。

在 Web 控制台中导出报表

Qlik NPrinting web 控制台 可以导出所有使用特定 Qlik NPrinting 连接 的 Excel 和 PixelPerfect 报告到单个 Qlik Sense 应用程序。

  1. 登录 Qlik NPrinting。

  2. 从顶部菜单中,选择管理员 > 导出 QCS 模板。

  3. 使用下拉菜单选择 Qlik NPrinting 应用程序和 Qlik Sense 连接。

  4. 在 Qlik Cloud 中键入所需 Qlik Sense 应用程序的 URL。删除 URL 中的任何尾随 /。

  5. 单击下载。

您的浏览器将下载一个 ZIP 文件,其中包含:

  • 包含信息性错误消息的日志文件。

  • 一个子文件夹,包含所有 XLSX 格式的导出报告模板 (Qlik NPrinting 2024 年 2 月),或所有 XLSX 和 QPXP 格式的模板 (Qlik NPrinting 2025 年 2 月),或 XLSX、QPXP 和 QHTML 格式 (Qlik NPrinting 2025 年 2 月 SR3),或 XLSX、QPXP、QHTML、DOCX、PPTX 格式 (Qlik NPrinting 2026 年 5 月)。

信息注释

导出的文件可能包含 Qlik Cloud 报告中不支持的报表功能。要根据当前 Qlik Cloud 功能验证报表,请参阅:

在 Excel、Word 或 PowerPoint 中使用报告,结合 Qlik 适用于 Microsoft Office 的加载项

在您的 Qlik Cloud 租户中使用 PixelPerfect 报表

在您的 Qlik Cloud 租户中使用 HTML 报表

使用 API 导出报表

NPrinting API 可以导出 NPrinting 应用程序中包含的所有 Excel、PixelPerfect 和 HTML 报表模板。您还可以选择导出特定选定的报告。

API 规范

有关完整规范,请参见文件 nprinting-api-yaml 或 nprinting-api.json。

高亮显示

/applications/{id}/actions/export-templates: post: tags: - ApiApps parameters: - name: id in: path required: true type: string format: uuid - name: request in: body required: true schema: $ref: '#/definitions/AppExportTemplates' responses: '200': description: OK schema: type: object AppExportTemplates: required: - connectionsMap type: object properties: connectionsMap: type: object additionalProperties: type: string type: enum: - Excel type: string reports: type: array items: format: uuid type: string example: 00000000-0000-0000-0000-000000000000

connectionsMap 可以用于在 NPrinting 应用程序具有多个连接时提供连接映射。

生成的 ZIP 文件将包含通过每个不同 Qlik Sense 连接的子文件夹组织的报表模板。

reports 可用于提供应导出的 Qlik NPrinting 报表 ID 的列表。如果您只需要导出在给定连接上工作的报告的子集,请提供该列表。

使用示例

以下示例使用 JavaScript Fetch 函数仅下载 Qlik NPrinting 连接所附带的一个特定报告。

fetch("https://your-nprinting.server:4993/api/v1/apps/977bf78f-4c72-412d-bb26-cd4fc0ec1596/actions/export-templates", { "headers": { "accept": "application/json, text/plain, */*, application/x-zip-compressed", "accept-language": "en-US,en;q=0.9,it;q=0.8", "cache-control": "no-cache", "content-type": "application/json;charset=UTF-8", "pragma": "no-cache", "sec-ch-ua": "\"Not.A/Brand\";v=\"8\", \"Chromium\";v=\"114\", \"Google Chrome\";v=\"114\"", "sec-ch-ua-mobile": "?0", "sec-ch-ua-platform": "\"Windows\"", "sec-fetch-dest": "empty", "sec-fetch-mode": "cors", "sec-fetch-site": "same-origin", "x-xsrf-token": "YPUrvy9ybRUFkF+L+ga4lt9e8WIcCZV0y8dO5YG/tO8=" }, "referrer": "https://your-nprinting.server:4993", "referrerPolicy": "strict-origin-when-cross-origin", "body": "{\"connectionsMap\":{\"86a10bf3-aab4-4ebd-949f-f99cffaaa328\":\"https://your-cloud-tenant.qlikcloud.com/sense/app/a18e00a1-5bb0-4302-a759-f4967ab47aec\"}, \"reports\":[\"fd4f037c-a2f7-44e6-ae90-4dd76a92386c\"]}", "method": "POST", "mode": "cors", "credentials": "include" }). then(response => response.blob()) .then(blob => { var url = window.URL.createObjectURL(blob); var a = document.createElement('a'); a.href = url; a.download = "exported-templates-nprinting.zip"; document.body.appendChild(a); // we need to append the element to the dom -> otherwise it will not work in firefox a.click(); a.remove(); //afterwards we remove the element again });

可以修改调用的 Request URL 和 body 部分以更改导出行为。

在本例中:

  • ZIP 文件为:exported-templates-nprinting.zip

  • NPrinting 应用程序为:977bf78f-4c72-412d-bb26-cd4fc0ec1596

  • Qlik Sense 连接为:86a10bf3-aab4-4ebd-949f-f99cffaaa328

  • Qlik Sense 应用程序已部署到以下位置的 Qlik Cloud:https://your-cloud-tenant.qlikcloud.com/sense/app/a18e00a1-5bb0-4302-a759-f4967ab47aec

  • ZIP 文件将只包含一个选定的报告模板:fd4f037c-a2f7-44e6-ae90-4dd76a92386c。将不会导出附加到连接的所有其他报表。

在 Excel、Word 或 PowerPoint 中使用报告,结合 Qlik 适用于 Microsoft Office 的加载项

从 Qlik NPrinting 导出的报告可以与 Qlik 插件一起使用,适用于 Microsoft Office。有关适用于 Microsoft Office 的 Qlik 加载项的更多信息,请参阅使用Qlik加载项构建报表模板,适用于Microsoft Office。

  1. 解压 ZIP 文件中的文件。

  2. 在 Office 365 web 或桌面中打开文件。

  3. 载入 Qlik 插件,适用于 Microsoft Excel、Word 或 PowerPoint。

  4. 登录后,将打开一个对话框:迁移正在进行中。

  5. 迁移后,可能会出现一条消息,其中包含 Qlik Cloud 不支持的对象列表:

  6. 如果存在不受支持的对象,则有两个选项:

    1. 在 Qlik Cloud 报告中实现新功能之前,您可以保持报表模板不变。在 Qlik Cloud 中发布报表时,不支持特性的报告标记将不会被删除,也不会产生任何效果。

    2. 您可以删除标记:

      1. 选择Excel工作表、Word文档或PowerPoint演示文稿中不支持功能的标签。

      2. 在 Office 加载项的属性面板中选择 删除; 这也将删除 Office 文档中对应的标签。

在您的 Qlik Cloud 租户中使用 PixelPerfect 报表

  1. 从 ZIP 文件中提取 QPXP 文件。

  2. 访问您的Qlik Sense应用程序,在您的Qlik Cloud租户上,并将您的模板上传到该应用程序。请参阅 上传报表模板 了解详情。

  3. 在您的 Qlik Cloud 界面中编辑上传的模板。有关详细信息,请参阅 设计 PixelPerfect 报表模板。

在您的 Qlik Cloud 租户中使用 HTML 报表

  1. 从 ZIP 文件中提取 QHTML 文件。

  2. 在您的 Qlik Cloud 租户上访问您的 Qlik Sense 应用程序,并将您的模板上传到该应用程序。请参阅 上传报表模板 了解详情。

  3. 在您的 Qlik Cloud 界面中编辑上传的模板。有关详细信息,请参阅 设计 PixelPerfect 报表模板。

Qlik Cloud 中支持和不支持的特性

下表概述了 Qlik Cloud 中支持和不支持的 Qlik NPrinting Excel 模板特性。此外,Qlik Cloud 中不支持连接到多个应用程序的模板。

删除 Qlik NPrinting 中不支持的功能,然后再导出模板。如果您导入的模板包含不支持的功能,您将收到一个不支持的标签警告。从模板中删除标签Qlik Cloud不会移除警告,因为这些标签的元数据仍保留在模板中。

特性支持
特性 支持 注释

图片

支持

筛选器窗格在 Qlik Cloud 中不受支持

图像形式的工作表

不支持

表格

支持

列

支持

公式

支持

变量

支持

删除行

支持

仅适用于 Excel 模板

单元格

不支持

级别

支持

页面

支持

仅适用于 Excel 模板

对象筛选器

支持

支持在已迁移模板中进行对象级别过滤。在迁移或应用程序替换后验证对象映射,以确保预期输出。

第三方扩展名

不支持

既不是图像也不是表格。

已知问题

在 Excel 365 web 版本中打开 Excel 文件时,模板中的静态图像可能不会出现。在 Excel 功能区中切换编辑/查看视图将恢复图像可见性。

Visit the discussion forum at community.qlik.com

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们!