托管空间中的表格报告
您可以为需要严格数据管理的应用程序生成表格报告。使用与开发用于托管空间的应用程序数据模型相同的原则,您可以为应用程序内报告功能做好准备。这是通过在加载脚本中使用空间感知语法来实现的。
在开发准备发布到托管空间的应用程序时,请考虑以下事项:
该模板可以在发布应用程序之前或之后进行开发。如果在发布前创建模板,请在发布后更改连接的应用程序。
发布应用程序之前,必须向应用程序添加分发列表。在开发过程中,它可以由模拟数据源组成,而不是实际的数据源。分发列表中的源在加载脚本中被引用,因此必须使用空间感知语法编写脚本以准备发布。如果将分发列表作为源文件上载,则默认情况下会自动使用此语法。
发布后,可以根据已发布应用程序的报告用例,根据需要重新创建报告资产(模板、筛选器和报告任务)。分发列表中使用的真实数据源应添加到托管空间中。
现有的表格报告配置
如果您在 2024 年 3 月 26 日之前创建了报告配置和分发列表,则需要注意分发列表的文件上载过程的更改。
对于 2024 年 3 月 26 日之前创建的应用程序,在报告部分上传的分发列表源文件会自动重命名并添加到空间中。对这个重命名文件的引用随后被自动添加到加载脚本中。上传的源文件现在添加到空间时不再重命名。
若要在发布这些应用程序时继续使用现有的报告配置,请根据您的分发列表来源,按照下面相应的部分操作。或者,使用本页稍后显示的指南从头开始重新创建报告配置。
如果您上传了源文件
打开 数据加载编辑器 并查看分发列表脚本部分中的文件名引用。调整语法,使其使用指向当前空间的空间感知引用,而不是任何特定空间。例如,文件引用可能如下所示:
FROM "lib://DataFiles/reporting_source_your_app_ID.xlsx"
将此项更改为:
FROM "lib://:DataFiles/reporting_source_your_app_ID.xlsx"
您可以看到源应用程序的应用程序 ID 包含在文件名中。如果您希望在发布应用程序时运行此确切的脚本,请使用此确切名称将实际的通讯组列表文件添加到托管空间。
或者,您可以在开发空间中重命名源文件,更新加载脚本,然后发布。最后,添加具有更新名称的实际分发列表文件。
如果在脚本中手动使用远程数据源
如果手动将加载脚本配置为依赖于分发列表的其他数据源,则只需调整加载脚本以包含对数据源的相对、空间感知的引用(如果尚未这样做)。
有关更多信息和具体示例,请参阅受管空间中应用程序的数据源。
工作流
按照以下顺序在托管空间中使用表格报告。
应用程序开发
像往常一样,在您的开发空间(个人或共享空间)中开发应用程序,为将其发布到托管空间做准备。
开发模板和筛选器
如果需要,您可以在发布应用程序之前构建报告模板和筛选器。作为应用程序开发的一个阶段,这可能很有帮助,但添加到源应用程序的模板和筛选器不会保留在已发布的副本中。
如果您在发布之前创建了模板,并希望将其用于已发布的应用程序,请更改模板的已连接 Qlik Sense 应用程序。 您可以在加载项中执行此操作。或者,在将模板上传到已发布的应用程序时,在 Qlik Sense 应用程序中执行此操作。请参阅更改已连接的 Qlik Sense 应用程序。
准备分发列表引用
将分发列表添加到应用程序时,应用程序的加载脚本会发生更改。在已发布的应用程序中无法访问应用程序的加载脚本。因此,在发布应用程序之前,您需要将分发列表添加到该应用程序中。
在这个阶段,分发列表只需要成为实际文件或其他源的占位符,这些文件或源将用于托管空间中的分发列表。
该过程略有不同,具体取决于您的分发列表是源文件还是在脚本中手动添加的远程数据源。然而,基本概念是相同的。有关概述如何在加载脚本中使用空间感知语法的完整指南,请参阅受管空间中应用程序的数据源。
选项 1:直接上传源文件
按照常规步骤将源文件上载为分发列表:通过上传源文件添加分发列表。
您可以插入任何所需的占位符,而不是添加最终确定的收件人详细信息。这里重要的是上传一个文件,然后将该文件自动添加到开发空间并在脚本中引用。
您可以检查加载脚本中的 Distribution List 部分是否包含对文件的空间感知引用,并且不直接引用任何特定空间。当您将源文件作为分发列表上传到应用程序的报告部分时,会自动执行此操作。它应该是这样的:
FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"
此示例是一个空间感知引用,指向应用程序所在的当前空间。DataFiles 前面多余的冒号提供了所需的相对引用。
稍后,当您将应用程序发布到托管空间时,将实际的分发列表文件上传到托管空间。实际的分发列表必须与脚本中引用的文件具有相同的文件名。
选项 2:手动引用脚本中的数据源
按照常规过程在脚本中手动连接到远程分发列表源:在加载脚本中手动定义分发列表。
在编写脚本以连接到分发列表所需的数据源时,可以根据需要使用对文件和连接的模拟引用。在脚本中,数据源只需要具有与托管空间中相同的名称,并且对这些源的引用需要使用相对的空间感知语法。
发布应用程序
准备好加载脚本和分发列表后,应用程序就可以发布到托管空间了。有关发布应用程序的更多信息,请参阅发布应用程序。
更改已连接的 Qlik Sense 应用程序
如果您在发布应用程序之前创建了报告模板,则需要更新模板以引用正确的应用程序 ID。应用程序的已发布副本将具有与源应用程序不同的应用程序 ID。
此过程可在 Microsoft Excel 的 Qlik 加载项中完成,或在上传模板时在 Qlik Sense 中完成。在开始之前,您可以创建模板的单独副本,以将其与源应用程序的模板区分开来。
有关完整说明,请参阅。
从 Microsoft Excel 的 Qlik 加载项: 更改已连接的 Qlik Sense 应用程序
从 Qlik Sense : 更改已连接的 Qlik Sense 应用程序
始终可以直接在托管空间中开发和更新模板。
添加实际分发列表源
在托管空间中,根据加载脚本中的引用,创建加载分发列表所需的文件和连接。此步骤可以随时完成。
提供分发列表的数据源必须包含与源应用程序加载脚本中使用的分发列表源相同的参数名称(连接、文件和字段的名称)。
当连接的源添加到空间中时,您应该能够重新加载应用程序。
创建新的报告资产
您现在可以将报告资产添加到应用程序中。这可能包括模板、筛选器和报告任务。
权限
在托管空间中具有以下任何角色的用户都可以使用应用程序的表格报告:
所有者
可管理
可操作(仅限 专业或 Full User 授权)
有关更多信息,请参阅管理托管空间中的权限。
限制
表格报告不适用于从客户端托管 Qlik Sense(包括多云部署)发布或分发到 Qlik Cloud 的应用程序。要对这些应用程序使用表格报告,请使用迁移工具将应用程序迁移到 Qlik Cloud(请参阅设置 Qlik Cloud 迁移工具),或者手动导出应用程序并将其重新上载到 Qlik Cloud。
有关更多信息,请参阅导出或迁移的应用程序的表格报告。