# Qlik 报告服务 规范和限制

本帮助主题列出了在用户界面和通过 Qlik 报告服务 API 在 Qlik Cloud 分析 中进行报告时适用的能力和限制。它特别指出了适用于使用 Qlik 报告服务 可用的增值订阅选项的限制。

Qlik 报告服务 是 Qlik Cloud 订阅中的一组增值服务，从 Qlik Cloud 提供企业级报告功能。使用 Qlik 报告服务，可以使用以下功能：

* 应用程序内报告

* 报告方式 Qlik Automate

* 直接使用 Qlik 报告服务 API。请参阅：[报告](https://qlik.dev/apis/rest/reports)

有关在 Qlik Cloud 分析 中报告的更多信息，请参阅[从 Qlik Cloud 分析 报告](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/SaaS-reporting-intro.htm)。

本页列出了上述增值特性的限制。提供了以下信息：

* Qlik 报告服务 使用限制

* Qlik 报告服务 中每个增值特性的限制和规范

此页面上的信息不一定适用于 Qlik Cloud 中的其他报告特性（例如，订阅报告）。有关特定于这些特性的限制，请参阅与其相关的帮助主题。

## Qlik 报告服务 增值特性的消耗限制

除非另有说明，否则以下与消耗相关的限制适用于所有 Qlik Cloud 许可证。此页面上列出的容量是按计量的组合，表示订阅中每个包含的 Qlik 报告服务 特性的组合使用情况。

有关 Qlik Cloud 订阅的特定消费限额和容量，请与您的服务帐户所有者联系，并参阅您正在使用的 Qlik Cloud 订阅的服务条款。

每月报告的最大数量因您的 Qlik Cloud 许可证而异，可购买附加包。如果您需要更多报告，请联系您的租户管理员。

有关您的许可指标的详细信息，请参阅 [Qlik Cloud® 订阅](https://www.qlik.com/us/legal/product-terms)产品描述。管理员可以查看许可证信息，并监视 Administration 活动中心中生成的报告和自动化运行的数量。有关更多信息，请参阅[监控资源消耗](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-monitor-consumption.htm)。

有关您个人自动化的更多详细信息，请通过 Analytics 活动中心的自动化查看。租户管理员可以在 Administration 活动中心的主页选项卡上查看使用指标。

## 系统和软件要求 — Qlik 适用于 Microsoft Office 的加载项

参见 [系统和软件要求](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#SystemReqsAddIns)。

## 应用程序中报告的限制

这些限制适用于 Qlik Cloud 中的应用程序中报告功能。有关此功能的信息，请参阅 [使用 Qlik Cloud 分析 的应用程序内报表](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/InAppGeneral/cloud-in-app-reports-intro.htm)。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm)

#### 平台和产品可用性

* Qlik Cloud 政府 和 Qlik Cloud Government - DoD 支持应用内报表。支持使用适用于 Microsoft Office 的 Qlik 插件，针对 Qlik Cloud 政府 或 Qlik Cloud Government - DoD 租户中的应用程序开发报表模板。

* 

  应用内报告不适用于从 Client-Managed Qlik Sense（包括多云部署）发布或分发到 Qlik Cloud 的应用程序。要在这些应用程序中使用应用内报告，请使用 [Qlik Analytics 迁移工具](https://help.qlik.com/zh-CN/migration/Subsystems/AnalyticsMigrationTool/Content/Qlik-Analytics-Migration-Tool-Overview.htm) 迁移应用程序，或手动导出应用程序并将其重新上传到 Qlik Cloud。

* Direct Query 应用程序不支持报告功能，包括 Qlik 报告服务 增值功能和订阅报告。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm)

#### 字体和应用程序样式

* 在您的应用程序中使用自定义字体时，会假定您有必要的许可证来在 Qlik Sense 输出中使用该字体。为了确保您的字体是已授权的，请使用 Qlik Sense 中提供的多种开源字体来设计应用程序内容。

  如果您拥有默认 Qlik Sense 主题中不可用的字体所需的许可证，请参阅[使用自定义字体创建主题](https://qlik.dev/extend/create-custom-themes/custom-themes-fontfamily-examples)，了解如何将字体添加到自定义主题中。

* 在报告中使用自定义、第三方和/或专有字体时，假设您具有在 Qlik 报告服务 的输出中使用该字体所需的许可证。为了获得最佳打印输出，建议使用开源字体。

* 当所选字体中不支持的字符在应用程序内容中使用时，这些字符将以支持它们的字体呈现。如果使用自定义字体，可能会注意到不同的行为。

* 应用于工作表的自定义 CSS 样式不包含在报告中。

* 应用于应用程序中图表对象的阴影不会显示在生成的报告中。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm)

#### 应用内容的技术护栏

以下限制适用于与应用程序中报告相关的共享可视化。如果超出这些限制，您的报告将失败。如果出现此问题，请联系在应用程序中具有可以编辑权限的用户。

具体限制如下所示：

* 最大图像大小：4,000 x 4,000 像素

* 最小图像大小：图表为 5 x 5 像素，工作表为 20 x 20 像素

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm)

#### 特定于应用内任务配置的限制

* 一个报告任务最多可以生成 500 个唯一的报告。此限制的评估方式是针对添加到任务中的所有模板，而不是针对任务中的每个模板。此限制也适用于所有报告任务，无论是应用了一个还是多个周期。

* 您最多可以为报告任务选择三个字段进行循环。

* 报告任务的最长执行时间为 4 小时。

* 在 Qlik Cloud 租户中，同一用户最多可以创建 1000 个报告任务。用户可以通过删除创建的现有任务来释放报表任务。

* 您最多可以向应用程序的分发列表中添加 1000 个收件人和 1000 个组。收件人总数（无论是否在组中）不能超过 1000。

* 如果应用程序使用区域权限，则无法通过 Microsoft SharePoint 分发文件夹传递报表。

* 外部电子邮件客户端通常强制执行电子邮件附件的大小限制。请与您的电子邮件提供者联系，了解您的限制。

  交付到云存储连接器的报告没有文件大小限制。

* 报告筛选器与 Star 语句不兼容。如果应用程序在脚本中包含此语句，则带有筛选器的报表可能会显示意外结果。

* 使用搜索选择方法配置报告筛选器时，不支持某些搜索方法。有关更多信息，请参阅[报表筛选器限制](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-filters.htm#Report)。

* 隐藏字段和系统字段在要在报告筛选器中使用的字段列表中不可见。

* 如果应用程序包含一个或多个使用始终一个选定值属性配置的字段，则需要配置报告筛选器，以便筛选器为每个字段恰好选择一个值。这些报告筛选器需要应用于报告任务。

  如果筛选器不包含这些字段的值，或者根本没有筛选器与任务关联，则报告任务将失败。

* 一个报告任务最多可添加五个报告模板实例，包括同一模板的副本。例如，如果您在一项任务中两次添加 Excel 模板，一次是 .xlsx 输出，一次是 PDF 输出，这将被视为在任务中添加了两个模板。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm)

#### 按报表类型划分的限制——模板和应用程序内任务配置

这些限制与模板创建和报表生成配置都相关。

所有模板类型

* 通常，在创建报表模板时，如果应用程序中的实体在模板编辑器中的节点中不可用（例如，图表、级别或表格），这意味着该实体或实体内的某些内容在编辑器中的所选节点中不受支持。例如，来自应用程序的透视表不能添加到 级别 节点中，但可以添加到 图像 节点中。

* 报告模板中不支持以下对象：

  * 筛选器窗格

  * 地图

  * 具有以下超立方体类型的图表：树形、透视表或堆叠

* 您最多可以在报告模板中嵌套五个级别。

* 报告中生成的图像的最大数量为 1000。

* 生成的报告最多可以包含 50,000 个对象。 考虑以下方面：

  * 单个图表、变量值、级别值或表达式值算作一个对象。

  * 对于 表，500 个生成的单元格算作一个对象。

* 您可以添加到报告模板中的对象实例的最大数量为 200。

* 隐藏字段和系统字段在用于级别和页面的字段列表中不可见。

* 不支持使用计算的维度作为级别。具体而言，不支持以下用例：

  * 将计算维度添加为主项，将此主条目添加到图表，然后将图表用作级别。

  * 将计算的维度表达式添加到图表中，然后将该图表用作级别。

  但是，可以在级别内包含由计算维度列组成的表格数据。

* 在级别内使用主维度时，只能将主维度与单个类型一起使用。级别内部不支持向下钻取主维度。

* 类型为循环的主维度，在将图表插入到模板中以及通过任务计划报表时，将始终显示第一个维度。

* 对于基于具有 显示列条件 的图表列的报表内容，该列在加载项或设计器窗口中将不可见。您需要在将条件添加到模板之前将其从列中删除，然后根据需要重新添加条件。

* 加载脚本中不支持语义加载前缀。有关语义负载的信息，请参阅 [Semantic](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptPrefixes/Semantic.htm)。

* 不支持第三方扩展。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm)表格报告

本节列出了使用 Microsoft Excel 的 Qlik 加载项以及从 Excel 报告模板生成的报告时适用的限制。

* 不支持在 Excel 模板文件中使用自定义字体。如果您的模板包含无法用于生成报告的字体，则使用这些字体的元素将在生成的报告中改为使用默认 Excel 字体。

* Microsoft Excel 报表模板中不支持宏和脚本。

* Microsoft Excel 对 Excel 工作簿文件中包含的内容施加了某些约束。这些限制适用于 Excel 报告模板及其生成的输出。这包括单个 .xlsx 文件中的最大行数、列数和字符数。有关这些外部限制，请参阅 Microsoft 官方文档。

* 分析对象只能作为图表图像添加到 Excel 报告模板中。要将分析作为表格数据添加到模板中，请将其转换为应用程序中的图表。

* Excel 报告管理模板文件不支持敏感性标签或 Azure 信息保护 (AIP) 标签。也就是说，如果您的模板包含这些标签中的任何一个，则它们提供的数据限制将被忽略，报告生成将照常进行，并且生成的报告将不包含任何敏感性或 AIP 标签。如果输出需要敏感性或 AIP 标签，则可以在生成报告后手动将其添加到报告中。

* 表格 (Excel) 报表模板的最大文件大小为 10 MB。

PixelPerfect 报告

* 无法将 分析对象添加到 PixelPerfect 报告模板中。要将分析作为图像添加到模板中，请将其转换为应用程序中的图表。

  有关 分析 对象的更多信息，请参阅 [创建和编辑分析](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Analyses/creating-analyses.htm)。

* Qlik Cloud 分析 中的 PixelPerfect 报告不支持自定义字体。

* PixelPerfect 报表模板的最大文件大小为 10 MB。

HTML 报告

* 如果周期已应用于报告任务，则无法将 HTML 报告模板设置为生成嵌入式电子邮件信息。

* 只有当HTML 模板用作嵌入式电子邮件正文时，才支持收件人标记。这些标签在任何其他情况下都不会被替换，包括：

  * 报告预览

  * 以电子邮件附件形式生成报告

  * 为文件夹分发生成的报告 (Microsoft SharePoint)

  * 直接地使用 Qlik 报告服务 API

  * 从 Qlik Automate 生成的报告

* HTML 报表模板的最大文件大小为 10 MB。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm)PowerPoint 报告

* Qlik 对 PowerPoint API 的集成测试表明，适用于 Microsoft PowerPoint 的 Qlik 加载项有时可能不稳定和/或缓慢。Qlik 与 Microsoft 的调查已了解到这是一个已知状态，并且网络上的一些 API 与桌面版相比可能会导致不同的行为。如果报表开发人员在使用在线 Microsoft PowerPoint 加载项时遇到困难，请联系 [Qlik 支持](https://community.qlik.com/t5/Support/ct-p/qlikSupport) 报告此情况——但是，请使用 PowerPoint 的桌面版本继续进行报表开发。这将允许 Qlik 团队调查集成，同时报表开发人员可以继续进行报表开发。

* PowerPoint 报表模板的最大文件大小为 30 MB。

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm)Word 报告

本节列出了使用 Microsoft Word 的 Qlik 加载项以及从 Word 报告模板生成的报告时适用的限制。

* 分析对象只能作为图表图像添加到 Word 报表模板中。要将分析作为表格数据添加到模板中，请将其转换为应用程序中的图表。

* Word 模板对作为 [浮动图像](https://www.microsoft.com/en-us/microsoft-365/blog/2011/05/19/understanding-images-part-1-the-basics/) 添加的图表图像有以下限制：

  * 使用 Word 的桌面版本，您无法刷新这些图表图像。

  * 使用 Word 的网页版本，您无法刷新这些图表图像。此外，当您选择它时，属性不会自动打开，也不会在通过加载项打开其属性时，在 Word 文档中选择该对象。

* Word 报表模板的最大文件大小为 30 MB。

## 使用 Qlik Automate 进行报告的限制

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm)

#### 技术限制

以下限制适用于使用 Qlik Automate 进行报告。如果超出这些限制，您的报告将失败。如果出现此问题，请联系在应用程序中具有可以编辑权限的用户。

具体限制如下所示：

* 选择中的最大字段数：125

* 选择中的最大字段值数：一个或多个字段中的字段值总数为 150, 000

* 最大备用状态数：125

  [使用备用状态进行对比分析](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/alternate-states-comparative-analysis.htm)

* 最大修补程序数：100

  补丁是应用程序中应用的属性或样式。例如：向表列添加排序。

* 最大变量数目：1,100

  [在表达式中使用变量](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Variables/work-with-variables.htm)

* 最大图像大小：4,000 x 4,000 像素

* 最小图像大小：图表为 5 x 5 像素，工作表为 20 x 20 像素

* 报表中的最大页数：200

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Reporting-service-specifications-limitations.htm)

#### 其他规格与限制

* 如果创建 PDF 或 PowerPoint 报告，分辨率将为 300 DPI。

* 外部电子邮件客户端通常强制执行电子邮件附件的大小限制。请与您的电子邮件提供者联系，了解您的限制。

  交付到云存储连接器的报告没有文件大小限制。

* 将以 PowerPoint 格式输出到自动化的工作表不支持纵向布局。设置为纵向布局的工作表将转换为横向布局。但是，如果使用的是 Qlik 报告服务 API，则可以使用纵向布局。有关使用 API 创建报告的详细信息，请参阅[开发人员门户文档](https://qlik.dev/apis/rest/reports)。

* 在您的应用程序中使用自定义字体时，会假定您有必要的许可证来在 Qlik Sense 输出中使用该字体。为了确保您的字体是已授权的，请使用 Qlik Sense 中提供的多种开源字体来设计应用程序内容。

  如果您拥有默认 Qlik Sense 主题中不可用的字体所需的许可证，请参阅[使用自定义字体创建主题](https://qlik.dev/extend/create-custom-themes/custom-themes-fontfamily-examples)，了解如何将字体添加到自定义主题中。

* 当所选字体中不支持的字符在应用程序内容中使用时，这些字符将以支持它们的字体呈现。如果使用自定义字体，可能会注意到不同的行为。

* 如果您在应用程序中使用自定义主题来定义字体使用（例如，将字体文件直接添加到主题中），则各种输出中呈现的字体可能与您在应用程序中使用的字体不同。

* 应用于应用程序中图表对象的阴影不会显示在生成的报告中。

* 不支持第三方扩展。

* Direct Query 应用程序不支持报告功能，包括 Qlik 报告服务 增值功能和订阅报告。

* 在使用将图表添加到报告时，无法将分析单独添加到 Qlik Automate 内的报告中。可以使用向报告添加工作表或向报告中添加选择将带有分析的工作表添加到报告中。

* 使用 Qlik Automate 生成的导出报表中不包含工作表标题。这是设计使然，适用于 .xlsx、.pptx、HTML 和 PixelPerfect 输出。

* 应用于工作表的自定义 CSS 样式不包含在报告中。

有关您个人自动化的更多详细信息，请通过 Analytics 活动中心的自动化查看。租户管理员可以在 Administration 活动中心的主页选项卡上查看使用指标。