# 将报表模板从 Qlik NPrinting 导出到 Qlik Cloud 该 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 应用程序或针对特定选择的所有报表。 [查看视频短片](https://play.vidyard.com/4Jz8WsRBYYNfUaotMEcWoy) ## 先决条件 要将报表模板从 Qlik NPrinting 迁移到 Qlik Cloud ，您将需要： * 使用具有导出报表权限的用户所具备的 Qlik NPrinting web 控制台 访问权限。 * 一个 Qlik Sense 应用程序，它： * 最初在中 Qlik Sense Client-Managed 创建，并连接到 Qlik NPrinting。 * 已迁移到您的 Qlik Cloud 租户。您将需要应用程序的新 URL。有关迁移 Qlik Sense 应用程序的信息，请参阅 [Qlik Analytics Migration Tool 概览](https://help.qlik.com/zh-CN/migration/Subsystems/AnalyticsMigrationTool/Content/Qlik-Analytics-Migration-Tool-Overview.htm)。 信息注释一旦将 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 模板。 ![](https://help.qlik.com/zh-CN/migration/Content/Resources/Images/ui_export-qcs-template-nprinting.png) 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 的加载项](https://help.qlik.com/zh-CN/migration/Content/Migration/NPrinting/exporting-nprinting-excel-to-qlik-cloud.htm#Using) [在您的 Qlik Cloud 租户中使用 PixelPerfect 报表](https://help.qlik.com/zh-CN/migration/Content/Migration/NPrinting/exporting-nprinting-excel-to-qlik-cloud.htm#Using2) [在您的 Qlik Cloud 租户中使用 HTML 报表](https://help.qlik.com/zh-CN/migration/Content/Migration/NPrinting/exporting-nprinting-excel-to-qlik-cloud.htm#Using3) ## 使用 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](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/excel-add-in-overview.htm)。 执行以下操作： 1. 解压 ZIP 文件中的文件。 2. 在 Office 365 web 或桌面中打开文件。 3. 载入 Qlik 插件，适用于 Microsoft Excel、Word 或 PowerPoint。 4. 登录后，将打开一个对话框：迁移正在进行中。 ![](https://help.qlik.com/zh-CN/migration/Content/Resources/Images/ui_export-qcs-template-nprinting-migration-progress.png) 5. 迁移后，可能会出现一条消息，其中包含 Qlik Cloud 不支持的对象列表： ![](https://help.qlik.com/zh-CN/migration/Content/Resources/Images/ui_export-qcs-template-nprinting-unsupported-tags.png) 6. 如果存在不受支持的对象，则有两个选项： 1. 在 Qlik Cloud 报告中实现新功能之前，您可以保持报表模板不变。在 Qlik Cloud 中发布报表时，不支持特性的报告标记将不会被删除，也不会产生任何效果。 2. 您可以删除标记： 1. 2. 选择Excel工作表、Word文档或PowerPoint演示文稿中不支持功能的标签。 3. 在 Office 加载项的属性面板中选择 删除； 这也将删除 Office 文档中对应的标签。 ## 在您的 Qlik Cloud 租户中使用 PixelPerfect 报表 执行以下操作： 1. 从 ZIP 文件中提取 QPXP 文件。 2. 访问您的Qlik Sense应用程序，在您的Qlik Cloud租户上，并将您的模板上传到该应用程序。请参阅 [上传报表模板](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/cloud-in-app-reports-templates.htm#UploadTemplate) 了解详情。 3. 在您的 Qlik Cloud 界面中编辑上传的模板。有关详细信息，请参阅 [设计 PixelPerfect 报表模板](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/design-pixelperfect-templates.htm)。 ## 在您的 Qlik Cloud 租户中使用 HTML 报表 执行以下操作： 1. 从 ZIP 文件中提取 QHTML 文件。 2. 在您的 Qlik Cloud 租户上访问您的 Qlik Sense 应用程序，并将您的模板上传到该应用程序。请参阅 [上传报表模板](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/cloud-in-app-reports-templates.htm#UploadTemplate) 了解详情。 3. 在您的 Qlik Cloud 界面中编辑上传的模板。有关详细信息，请参阅 [设计 PixelPerfect 报表模板](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/design-html-reports.htm)。 ## Qlik Cloud 中支持和不支持的特性 下表概述了 Qlik Cloud 中支持和不支持的 Qlik NPrinting Excel 模板特性。此外，Qlik Cloud 中不支持连接到多个应用程序的模板。 删除 Qlik NPrinting 中不支持的功能，然后再导出模板。如果您导入的模板包含不支持的功能，您将收到一个不支持的标签警告。从模板中删除标签Qlik Cloud不会移除警告，因为这些标签的元数据仍保留在模板中。 特性支持 | 特性 | 支持 | 注释 | | --- | --- | --- | | 图片 | 支持 | 筛选器窗格在 Qlik Cloud 中不受支持 | | 图像形式的工作表 | 不支持 | | | 表格 | 支持 | | | 列 | 支持 | | | 公式 | 支持 | | | 变量 | 支持 | | | 删除行 | 支持 | 仅适用于 Excel 模板 | | 单元格 | 不支持 | | | 级别 | 支持 | | | 页面 | 支持 | 仅适用于 Excel 模板 | | 对象筛选器 | 支持 | 支持在已迁移模板中进行对象级别过滤。在迁移或应用程序替换后验证对象映射，以确保预期输出。 | | 第三方扩展名 | 不支持 | 既不是图像也不是表格。 | ## 已知问题 在 Excel 365 web 版本中打开 Excel 文件时，模板中的静态图像可能不会出现。在 Excel 功能区中切换编辑/查看视图将恢复图像可见性。