故障排除 - 应用程序中报告

上传分发列表文件时应用程序重新加载失败

可能的原因  

这可能是由于在添加分发列表之前，加载脚本末尾的格式存在许多问题。

常见示例：

• 在当前加载脚本的末尾有一个 Exit script 语句。

• 加载脚本中最后一个 LOAD 或 SELECT 语句的末尾缺少分号。

建议的操作  

给定上面的示例，以下解决方案可能有效：

• 将新添加的 Distribution List 脚本段移动到 Exit script 语句上方的新位置。或者，如果考虑到对您的用例和脚本上下文是有意义的，则删除 Exit script 语句。

• 添加缺少的分号。

报告任务：“无法发送至某些用户”。

报告任务可能会发送给某些用户，但无法发送给其他用户。

可能的原因 1

分发列表中这些收件人的电子邮件地址已更改。为添加到报告任务的每个收件人生成报告时，Qlik Cloud 会在分发列表中搜索电子邮件地址。如果未找到匹配项，则无法为用户生成报告。

可能的原因 2

在应用程序中找不到分发列表中引用的一个或多个报告筛选器。

• 筛选器的名称已在应用程序中更改，但未在分发列表中更新。

• 应用程序中删除了一个筛选器，但它仍在分发列表中被引用。

• 分发列表中引用的筛选器尚未添加到应用程序中。

建议的操作 1

最佳做法是使用组将用户添加到报告任务中。组是收件人的集合。当您更改已作为组的一部分添加到任务中的收件人的电子邮件地址时，将生成报告并将其发送到更新的电子邮件地址。

如果确实需要向报告任务中添加单个收件人，请从报告任务中删除原始用户，然后使用其更新的电子邮件地址重新添加他们。

有关更多信息，请参阅为报表创建分发列表。

建议的操作 2

更新筛选器名称，使其在应用程序和分发列表之间对齐。根据需要添加筛选器。如果某个筛选器已删除且不再适用，请从分发列表中删除其引用。

报告任务：“发送失败：无法生成”

可能的原因 1

该模板使用了表格报告不支持的 Excel 功能。

示例：

• 适用于应用程序、宏和脚本的 Visual Basic

• 第三方扩展

可能的原因 2

应用程序中的一个或多个字段配置为始终选择一个值，并且没有任何应用于报告任务的报告筛选器为每个字段选择一个精确的值。

可能的原因 3

发生了以下情况：

• 您使用一个或多个列标记将应用程序中表格图表中的数据添加到模板中。

• 在应用程序中，一个或多个表列具有在应用程序中应用至其的显示列条件设置。

• 在生成报告时，未满足这些列的显示列条件。

当您添加与表格图表上设置的显示列条件关联的列标记时，必须在使用该模板的报告任务运行时满足该条件。否则，报告任务将失败。

建议的操作 1

创建一个不使用不支持的 Excel 功能的模板。

有关 Microsoft Excel 的 Qlik 加载项的限制列表，请参阅Qlik 报告服务 规范和限制。

建议的操作 2

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

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

建议的操作 3

删除列标记，并将表格图表数据作为表格标记添加回模板。即使不满足条件，使用此模板的报告任务也将成功运行。

报告任务执行失败 - 已达到唯一报告的最大数目

报告任务执行失败，并且显示以下信息：

报表未发送，因为已达到此任务的唯一报表的最大数量。有关详细信息，请查看收件人列表。

可能的原因  

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

建议的操作  

编辑报告任务，更改定义，使每次执行所生成的唯一报告少于 500 份。如果您仍然需要一次生成 500 份以上的唯一报告，您可创建具有类似交付设置的单独任务。

我的报告没有包含我认为会包含的数据

可能的原因 1

加载脚本包含一条 Star 语句，并且报告被设置为使用筛选器。

可能的原因 2

报告是从使用对象筛选器的 Qlik NPrinting 模板迁移而来的。

建议的操作 1

重新处理加载脚本，使其在不使用任何 Star 语句的情况下按预期运行。

建议的操作 2

不支持将对象筛选器与 Qlik Cloud 表格报告一起使用。对模板进行重新处理，使其在不使用对象筛选器的情况下获得所需的结果。

有关更多信息，请参阅将 Excel 报告模板从 Qlik NPrinting 导出到 Qlik Cloud。

报告任务已被禁用

可能的原因 1

已在应用程序中添加或删除区域权限表。

可能的原因 2

该应用程序具有区域权限，并且租户管理员已更改报告任务的所有者。这会自动禁用报告任务。在这种情况下，只有报告任务的新所有者才能重新启用该任务。

建议的操作 1

评估区域权限表中定义的数据安全限制是否可用于报告任务用例。如果可以接受，请重新启用报告任务。

建议的操作 2

报告任务所有权的更改可能会影响应用于任务的各个收件人的数据减少。请记住，如果将报告任务配置为向 Qlik Cloud 租户中非用户的个人发送报告，则他们将收到的数据将与新报告任务所有者收到的数据相同。

当新的报告任务所有者评估了配置并进行了任何必要的更改后，他们可以重新启用报告任务。

有关更多信息，请参阅应用内报告和区域权限。

将 Excel 模板上传到 Qlik Sense 应用程序时遇到错误

当您尝试上传已连接到其他 Qlik Sense 应用程序的模板时，您可能会收到此错误。

无法上传模板文件。该模板引用了 Qlik Sense 应用程序中不可用的对象。

当您在上传新模板时尝试更新连接的 Qlik Sense 应用程序时，可能会出现此错误，可能是因为现有应用程序的复制或已发布副本。

可能的原因 1

模板中的内容使用了私有工作表中的对象。导出、复制或发布应用程序时，不包括私有工作表。为了能够更改模板的连接的应用程序，模板中引用的所有应用程序对象都必须在新应用程序中找到。

可能的原因 2

模板中引用的一个或多个单个对象存在问题。

建议的操作 1

请执行以下操作之一：

• 返回到原始源应用程序，并将引用的私有工作表公开。

• 使用 Microsoft Excel 的 Qlik 加载项打开模板，并删除基于私有工作表的引用内容。

建议的操作 2

使用 Microsoft Excel 的 Qlik 加载项打开模板。在此处，您可以找到每个对象的更多描述性错误消息，并进一步诊断问题。例如，您可能已经从 Qlik NPrinting 迁移了模板，并且模板引用了 Qlik Cloud 表格报告中不支持的图表类型。

Microsoft Excel：部署 Qlik 加载项后进行身份验证时显示空白对话框

当用户尝试对加载项进行身份验证时，其身份验证弹出对话框可能为空。或者，用户可以在对话框中看到错误（具体而言是 12006）。

对于要使用 Microsoft Excel 的 Qlik 加载项的用户，身份验证流需要在租户和托管在不同域中的身份提供者之间进行重定向。您的身份提供者正在使用限制性设置设置 Cross-Origin-Opener-Policy。因此，身份验证流的跨域通信部分被阻止，从而无法将登录信息正确返回到加载项。

建议的操作  

以下解决方案应由负责设置身份提供者的网络管理员执行。

执行以下操作：

• 将 IDP 到对话框的响应标头设置为：

  Cross-Origin-Opener-Policy: unsafe-none

有关详细信息，请参阅 Microsoft 官方文档：Office 对话框 API - 规则和 gotchas

Microsoft Excel：模板中未显示静态图像

可能的原因 1

作为用户，您在 Qlik Cloud 租户中没有足够的权限从应用程序下载图像。

可能的原因 2

Microsoft Excel 遇到一个小的同步问题。此问题仅限于 Excel for Microsoft 365 的 Web 版本。

建议的操作 1

如果需要为您分配其他权限，请与租户管理员联系。

如果您是租户管理员，请参阅：

• 用户和管理员的角色和权限（基于用户的订阅）

• 用户和管理员的角色和权限（基于容量的订阅）

• 用户和管理员的角色和权限（Qlik Anonymous Access 订阅）

建议的操作 2

在 Excel 功能区中切换编辑/查看视图将恢复图像可见性。

Microsoft Excel：在 macOS 中保存和在 Windows 中重新打开后，模板看起来有所不同

具体而言，您可能会注意到静态图像的尺寸不同。该文件现在可能也有不同的字体。

可能的原因  

macOS 和 Windows 在 Excel 文件中显示图像的方式存在技术差异。此外，文件中的字体可能会更改。macOS 和 Windows 之间的默认字体不相同，通常，字体支持也不相同。

建议的操作  

在开发模板时，尽量避免在操作系统之间来回切换。如果无法避免（例如，在协作模板开发的情况下），请根据需要调整 Excel 工作簿中的字体和主题。这些设置位于页面布局下。

图像尺寸的更改很难修复，因此对于使用图像的报告，请考虑使用相同的操作系统来开发整个模板。

Excel 模板生成的报告中使用了不正确的字体

可能的原因  

模板中使用了自定义字体。

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

建议的操作  

编写 Excel 模板时，请使用与您最初使用的自定义字体最匹配的 Excel 字体。这是避免报告输出中出现意外结果的最佳方法。

文件名（或文件名预览）中用于报告生成的时间戳不正确

可能的原因  

报告任务所有者尚未在其个人设置中设置首选时区。当没有明确设置首选时区时，报告文件名使用 UTC 时间戳。

建议的操作  

拥有报告任务的用户需要在其个人设置中设置时区。

执行以下操作：

1. 在 Qlik Cloud 中，单击右上角的用户概要菜单。

2. 单击设置。

3. 在时区下，选择您首选的时区。

更改应用程序中的图表后无法生成 PixelPerfect 报告

可能的原因  

源应用程序对象中的维度和度量已被添加、删除或重新配置。

建议的操作  

有关更多信息，请参阅Data binding。