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

Qlik NPrinting 导出功能可转换连接到 Qlik Sense Enterprise on Windows 应用程序的 Excel r报表模板。此转换后的报表格式可以与您的 Qlik Sense 应用程序一起导入 Qlik Cloud。迁移后的报表模板可以在 Microsoft Excel 的 Qlik 加载项中进行编辑，并使用 Qlik Cloud 进行分发。

用户可以导出 Excel 模板：

在 Qlik NPrinting web 控制台中：您可以导出连接到特定 Qlik Sense 应用程序的所有 Excel 报表模板。
使用 NPrinting API：您可以选择导出 Qlik NPrinting 应用程序或针对特定选择的所有报表。

先决条件

要将报表模板从 Qlik NPrinting 迁移到 Qlik Cloud ，您将需要：

使用具有导出报表权限的用户所具备的 Qlik NPrinting web 控制台访问权限。
一个 Qlik Sense 应用程序，该应用程序：
- 最初在中 Qlik Sense 客户端托管创建，并连接到 Qlik NPrinting。
- 已迁移到您的 Qlik Cloud 租户。您将需要应用程序的新 URL。有关迁移 Qlik Sense 应用程序的信息，请参阅迁移应用程序。
  
  信息注释一旦 Qlik Sense 应用程序上传到 Qlik Cloud，请不要编辑仍在 Qlik Sense 客户端托管中的版本。对应用程序的一个版本所做的更改不会显示在另一个版本中。
一个或多个 Qlik NPrinting Excel 报表模板，其中包含从 Qlik NPrinting 连接到 Qlik Sense 客户端托管的对象。不支持以下内容：
- 连接到 QlikView 文档的报表。
- 连接到多个 Qlik Sense 应用程序的报表。

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

Qlik NPrinting 模板格式支持

Qlik NPrinting 支持通过自定义模板将 XLS、XLSX 和 XLSM 文件作为模板文件。所有模板都将转换为 XLSX 格式，以便可以导入到 Qlik Cloud。

出于安全考虑，带有宏 (XLSM) 的 Excel 文件将被转换为XLSX，并且宏将被删除。

在 Web 控制台中导出报表

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

执行以下操作：

登录 Qlik NPrinting。
从顶部菜单中，选择管理员 > 导出 QCS 模板。
使用下拉菜单选择 Qlik NPrinting 应用程序和 Qlik Sense 连接。
在 Qlik Cloud 中键入所需 Qlik Sense 应用程序的 URL。删除 URL 中的任何尾随 /。
单击下载。

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

包含信息性错误消息的日志文件。
一个子文件夹，包含 XLSX 格式的所有导出报表模板。

导出的文件可能包含 Qlik Cloud 报告中不支持的报表功能。要根据当前 Qlik Cloud 功能验证报表，请参阅将 Excel 中的报表与 Microsoft Excel 的 Qlik 加载项一起使用。

使用 API 导出报表

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

API 规范

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

高亮显示

/apps/{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 中的报表与 Microsoft Excel 的 Qlik 加载项一起使用

从 Qlik NPrinting 导出的报告可以与 Microsoft Excel 的 Qlik 加载项一起使用。有关 Microsoft Excel 的 Qlik 加载项的详细信息，请参见使用 Microsoft Excel 的 Qlik 加载项生成报表模板。

执行以下操作：

从 ZIP 文件中提取 Excel 文件。
在 Excel 365 web 或桌面中打开文件。
加载 Microsoft Excel 的 Qlik 加载项。
登录后，将打开一个对话框：迁移正在进行中。
迁移后，可能会出现一条消息，其中包含 Qlik Cloud 不支持的对象列表：
如果存在不受支持的对象，则有两个选项：
1. 在 Qlik Cloud 报告中实现新功能之前，您可以保持报表模板不变。在 Qlik Cloud 中发布报表时，不支持特性的报告标记将不会被删除，也不会产生任何效果。
2. 您可以删除标记：
  1. 为 Excel 工作表中不受支持的特性选择标记。
  2. 通过删除单元格内容删除标记。
  3. 对于页面，请编辑工作表名称以删除相应的标记。

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

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

特性支持
特性	支持	注释
图片	支持	筛选器窗格在 Qlik Cloud 中不受支持
图像形式的工作表	不支持
表格	支持
列	支持
公式	支持
变量	支持
删除行	支持
单元格	不支持
级别	支持
页	支持
对象筛选器	不支持	可以导出报告，但不会应用筛选器。
第三方扩展名	不支持	既不是图像也不是表格。

已知问题

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

本页面有帮助吗？

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

在此处留下您的反馈