为报表创建分发列表
在创建报表任务之前,您必须定义作为报表基础的 Qlik Sense 应用程序的分发列表。分发列表包含所有收件人和收件人组,这些收件人可以是应用程序报表任务的接收人。
使用分发列表可以配置要向其发送报表的个人。配置报表任务时,从分发列表中选择将接收该特定报表任务输出的收件人和组。
分发列表提供了以下详细信息:
-
从应用程序生成的表格报表的所有收件人,包括他们的姓名、电子邮件地址、适用于他们的筛选器以及他们属于哪些组。
-
可以接收应用程序生成的报表的所有组(一个或多个收件人的集合)。
如果您将源文件作为分发列表上传,它将显示在应用程序报告部分的收件人和组选项卡中。
一个应用程序只能添加一个源文件。如果需要更改源文件,请编辑最初上传的文件(或数据源),然后重新上传。如果使用数据连接来定义分发列表,请根据需要对脚本进行编辑。请注意,执行此操作时,必须根据需要对报表任务配置和筛选器进行等效的更改。
谁可以接收表格报告?
在 Qlik Cloud 分析 中,您可以向内部和外部收件人发送 Excel 电子邮件报告。
内部收件人的标识
收件人的电子邮件地址用于识别他们是否为内部收件人。如果电子邮件地址与 Qlik Cloud 租户中用户的电子邮件地址匹配,则收件人为内部收件人。如果找不到匹配项,则收件人是外部收件人。
输出和区域权限
下表介绍了每种类型的收件人以及他们希望在报告中看到的内容。此表概述了具有和不具有区域权限的应用程序的行为。有关表格报告和区域权限的更多信息,请参阅 表格报告和区域权限。
收件人类型 | 说明 | 行为 |
---|---|---|
内部 | Qlik Cloud 租户中的用户,由匹配的电子邮件地址标识。 要了解如何将用户添加到 Qlik Cloud 租户,请参阅:
| 除非应用程序使用区域权限,否则此收件人报告中包含的数据将基于报告任务所有者对应用程序的访问权限。 |
外部 | 未在 Qlik Cloud 租户中的用户。 | 报告中包含的数据始终基于报告任务所有者的访问权限,无论应用程序是否使用区域权限。 |
Microsoft SharePoint 报告分发
如果您改为通过分发文件夹 (Microsoft SharePoint) 分发报告,则任何有权访问相应连接中指定位置的人都可以访问这些报告。内部收件人的标识与电子邮件输出的标识相同。
如果应用程序使用区域权限,则无法通过 Microsoft SharePoint 分发文件夹传递报告。
通过分发文件夹发送报表时,仍必须为应用程序定义分发列表以生成报表输出。分发列表仍然有助于确定运行报表任务时生成的报表输出版本(通常,每个收件人筛选器一个文件)。有关将报表存储到分发文件夹的详细信息,请参阅将表格报表传递到分发文件夹。
分发列表、收件人筛选器和任务输出
分发列表控制分别应用于每个收件人的报表筛选器。当您将分配列表添加到应用程序时,将为您应用于它们的每个筛选器创建一个单独的收件人。配置报表任务时,将每个收件人添加为与单个筛选器相对应的用户筛选器配对。
例如,如果将筛选器 A 和 B 应用于名为 User1 的收件人,则会将两个收件人添加到应用程序中 - 使用筛选器 A 的 User1 ,使用筛选器 B 的 User1。
有关如何配置报表任务以生成所需输出的更多信息,请参阅:
重新加载计划所有权注意事项
分发列表通过自动或手动修改应用程序的加载脚本来工作。当您执行以下任何操作时,您可能会成为应用程序重新加载计划的新所有者:
将源文件作为分发列表上传
删除分发列表
对加载脚本进行任何手动编辑
了解这些场景很重要,因为在按时间表重新加载时,计划的所有者必须具有对应用程序及其数据源的所需访问权限。否则,应用程序将无法重新加载。
有关更多信息,请参阅重新加载计划的所有权。
添加分发列表
使用以下两种方法之一添加分发列表:
上传源文件
在加载脚本中手动定义收件人和组
在下面的各部分中解释了每种方法。
通过上传源文件添加分发列表
您可以通过上传包含所需信息的源文件来定义分发列表。此文件必须包含特定的格式和结构。创建源文件的最简单方法是下载示例文件,并使用收件人和组信息对其进行修改。
将源文件作为分发列表上传将替换现有的源文件(如果有)。对一个应用程序只能应用一个源文件。如果上传源文件,此文件将替换以前上传到应用程序的源文件(如果有)。如果新旧文件不匹配,这可能会导致现有报表任务失败。
当您通过上传源文件添加分发列表时,会在应用程序的加载脚本中自动生成一个新的部分(Distribution List),并重新加载应用程序。此脚本段列出了应用程序的收件人和组。分发文件中的详细信息随后可以在应用程序的数据模型中访问。
将源文件作为分发列表上载时,该文件也会作为数据文件添加到包含应用程序的空间中。Distribution List 脚本段将此文件作为空间中的一个项引用。
注意事项
在上传源文件之前,请考虑以下重要详细信息:
新的Distribution List脚本段将作为脚本中的最后一个部分添加。因此,Distribution List之前最后一部分的任何脚本格式问题都将导致重新加载失败。例如,这可能类似于在要加载的最后一个表的末尾没有分号。
请勿修改自动生成的 Distribution List 脚本段中的 SubField 函数表达式。这些表达式是支持筛选器和组的逗号分隔值所必需的。
SubField([Filters],',') AS [DL_DISTRIBUTION_FILTERS], SubField([Groups],',') AS [DL_DISTRIBUTION_GROUP_NAMES]由于上传源文件的工作方式是将数据加载到您的应用程序中,因此它也计入 Qlik Cloud 订阅中定义的购买数据加载量(仅适用于基于容量的订阅)。参阅Qlik Cloud 基于容量的订阅。
下载示例文件
示例源文件是一个 Excel 工作簿,您可以在将其上传到应用程序之前进行修改。
执行以下操作:
打开应用程序的报告部分中的收件人或组选项卡。
单击添加收件人和组。
选择 下载示例。
下载示例文件后,可以对其进行修改以添加应用程序的收件人和组。
添加收件人
打开刚下载的示例文件,确保打开了以下工作表:
DL_DISTRIBUTION_SVC_USERS_QCS
接下来,您可以替换工作表中的数据以添加自己的收件人。不要更改或删除显示列标题的第一行。
执行以下操作:
在名称列中,添加收件人的名称。
在电子邮件列中,添加收件人的电子邮件地址。请注意,此列会自动格式化为具有电子邮件地址目的地的超链接。
在筛选器列中,添加与应用程序报告部分的筛选器选项卡中添加的筛选器组相对应的筛选器组。用逗号分隔筛选器组。
在组列中,添加收件人所属的组。用逗号分隔每个组。
添加组
在源文件中,工作表中定义了具有以下标题的组:
DL_DISTRIBUTION_SVC_GROUPS_QCS
打开此工作表并替换数据以在分发列表中创建组。不要更改或删除显示列标题的第一行。
执行以下操作:
在名称列中,添加组的名称。
在描述列中,添加组的说明。
上传分发列表文件
创建源文件后,将其上传到应用程序报告部分的收件人或组选项卡中。当您这样做时,应用程序会重新加载,收件人和组会填充到各自的部分中。
执行以下操作:
打开收件人或组选项卡。
单击添加收件人和组。
选择上传新版本 (.xlsx)。
在加载脚本中手动定义分发列表
通过文件上传添加分发列表会间接修改应用程序的加载脚本。或者,直接使用加载脚本来添加收件人和组。这是一个适合高级用户的选项,如果您想使用数据源连接来提供收件人和组信息,这将特别有用。
例如,如果您的收件人和组是在外部源文件中定义的,或者位于数据库或人力资源系统中(例如,Workday),则此选项允许应用程序中的收件人和小组根据连接的源动态更新。
要求
为了使脚本中的字段被识别为属于应用程序的分发列表,您必须将标记应用于与分发列表的必需元素相对应的每个必填字段。有关详细信息,请参阅下表。
需要标签的字段 | 所需标签 | 示例 |
---|---|---|
收件人名称 | DL_DISTRIBUTION_SVC__recipientName | tag field [GetSheetValues.Name] with 'DL_DISTRIBUTION_SVC__recipientName' |
收件人电子邮件地址 | DL_DISTRIBUTION_SVC__recipientEmail | tag field [GetSheetValues.Email] with 'DL_DISTRIBUTION_SVC__recipientEmail' |
收件人筛选器 | DL_DISTRIBUTION_SVC__recipientFilters | tag field [GetSheetValues.Filters] with 'DL_DISTRIBUTION_SVC__recipientFilters' |
群组名称 | DL_DISTRIBUTION_SVC__groupsName | tag field [GetSheetValues.Groups] with 'DL_DISTRIBUTION_SVC__groupsName' |
组描述 | DL_DISTRIBUTION_SVC__groupDescription | tag field [GetSheetValues.GroupDescription] with 'DL_DISTRIBUTION_SVC__groupDescription' |
示例脚本
以下是连接到收件人和组的脚本段的示例:
删除分发列表
如果需要,您可以从应用程序中删除所有收件人和组。
执行以下操作:
打开收件人或组选项卡。
单击任何收件人或组旁边的 ,然后选择 全部删除。
表格报告和区域权限
如果应用程序使用区域权限,则报告生成的工作方式会有所不同。有关详细信息,请参阅 表格报告和区域权限。
托管空间中的分发列表
对于托管空间中的应用程序,无法从应用程序的报告部分编辑分发列表。在将应用程序发布到托管空间之前,请上载模拟分发列表文件,或在脚本中手动引用所需的远程源。建议在加载脚本中使用空间感知语法。换句话说,对数据源的引用应该指向应用程序所在的当前空间。根据您添加分发列表的方式,可能会自动使用此语法。
提供分发列表的数据源必须包含与源应用程序加载脚本中使用的分发列表源相同的参数名称(连接、文件和字段的名称)。
您可以将分发列表的实际数据源上载到托管空间。
有关更多信息,请参阅以下指南:
分发列表的权限
管理 Qlik Sense 应用中的分发列表需要特定的角色。权限要求因应用所在空间的类型而异。
对于共享空间中应用程序的要求
以下要求适用于共享空间中的应用:
要在应用程序的报告部分查看分发列表,您需要该空间的可以编辑访问权限。
若要编辑、重新上传和删除分发列表,您必须在空间中具有可以编辑应用程序中的数据访问权限。
有关更多信息,请参阅管理共享空间中的权限。
对于托管空间中应用程序的要求
分发列表不能在托管空间中直接配置。加载脚本引用将用于加载分发列表的数据源。若要将这些数据源添加到空间中,您必须具有在托管空间中添加和管理数据源所需的权限。有关更多信息,请参阅管理托管空间中的权限。
有关托管空间中的表格报告的更多信息,请参阅托管空间中的表格报告。
个人空间中应用程序的要求
您必须在租户中具有 Private Analytics Content Creator 用户角色,才能完全控制分发列表。
分发列表限制
不能在包含收件人和组的名称以及收件人的电子邮件地址的字段中使用逗号。此限制既适用于将分发列表作为文件上载,也适用于在加载脚本中手动定义它。
您最多可以向应用程序的分发列表中添加 1000 个收件人和 1000 个组。