内容:

订阅疑难解答

  • 版本 :2022.1 及更高版本

订阅疑难解答

"此电子邮件中的视图快照无法正确呈现。”

如果您接收的订阅出现此错误消息,可能是由以下几种原因导致的:

  • 缺失凭据:某些视图在发布时具有嵌入的凭据。如果嵌入式凭据现已过时或视图在重新发布时未包含嵌入式凭据,则您可能会收到以上错误消息。

  • 数据库暂时瘫痪:如果视图具有实时数据库连接,且数据库在生成订阅时暂时瘫痪,则您可能会收到以上错误消息。

  • 后台进程超时:默认情况下,对于视图的呈现,处理订阅的后台进程的每个视图的超时值为 30 分钟。如果呈现视图超过此时间限制,则工作簿中的下一个视图会由于超时而导致作业失败。大部分情况下,此默认时间已经足够。但如果后台进程在处理极大且非常复杂的仪表板,30 分钟可能就不够。您可以检查非数据提取后台任务管理视图,看看是否出现了这种情况。若要提高超时阈值,请使用 tsm configuration set subscriptions.timeout 命令。

无法在电子邮件中看到图像

为了使内容图像在订阅电子邮件中显示,订阅视图的用户除了“查看”权限外,还必须拥有“下载图像/PDF”权限。有关详细信息,请参见权限

无法订阅

如果您在 Tableau Server 上可以看到视图并且该视图的右上角有一个订阅图标 (),则您可以订阅该视图。

若要订阅视图,需要正确配置 Tableau Server(请参见管理订阅(链接在新窗口中打开)),并且您订阅的视图必须已嵌入其数据源的凭据或者根本不需要凭据。后一种情况的示例连接到不需要刷新的数据提取的工作簿,或其数据位于发布时工作簿附带的文件中的工作簿。嵌入凭据的步骤在 Tableau Desktop 中执行(有关详细信息,请参见 Tableau 帮助(链接在新窗口中打开))。

没有订阅图标

可以看到视图但无法订阅它。发生此错误的原因是原因有多种:

  • 没有计划订阅:如果没有计划任何订阅,则订阅图标将不会出现。若要设置订阅计划,请参见创建或修改计划(链接在新窗口中打开)

  • 视图使用实时数据库连接:包含实时数据库连接的视图(当您首次单击视图时,将在该视图中提示您输入数据库凭据)不可用于订阅。订阅包括视图(或工作簿)、数据和计划。为了交付视图所需的数据,Tableau Server 需要嵌入式数据库凭据或不需要凭据的数据。至于实时数据库连接,Tableau Server 没有相关凭据,只有单个用户拥有凭据。这就是为什么您只能订阅不需要凭据或已嵌入凭据的视图的原因所在。

  • Tableau Server 配置为使用受信任的身份验证:如果 Tableau Server 配置为使用受信任的身份验证,您也可能可以看到视图但无法订阅它(没有订阅图标)。有关详细信息,请参见确保访问订阅(链接在新窗口中打开)

接收的订阅无效或“损坏”订阅

如果除了生产实例,您还配置了 Tableau Server 测试或开发实例上的订阅,请禁用非生产实例上的订阅。在所有实例上将订阅保持为启用状态会导致您用户接收到看起来有效但实际无法运作的订阅,或接收到已在视图或工作簿上取消的订阅。

缺少 PDF 附件

您可以将 PDF 附件添加到订阅中(如果管理员已启用该功能)。如果订阅中缺少 PDF 附件,可能是因为 PDF 的大小超过了电子邮件服务器大小限制或服务器管理员设置的最大大小限制。在 Tableau Server 中,可以通过 tsm configuration 选项 subscriptions.max_attachment_size_megabytes 调整订阅的 PDF 附件的最大大小限制。有关详细信息,请参见配置服务器事件通知设置订阅站点

挂起的订阅

默认情况下,订阅会在订阅连续五次失败后挂起。若要更改订阅挂起之前可发生的订阅失败阈值次数,请使用 tsm configuration set 选项 backgrounder.subscription_failure_threshold_for_run_prevention。此选项设置挂起订阅之前必需的订阅连续失败次数的阈值。这是一项服务器范围设置。

只有服务器管理员可以配置订阅挂起之前订阅失败次数的阈值。有关设置此阈值的信息,请参见设置订阅服务器

默认情况下,管理员在订阅挂起时不会收到电子邮件,但可以通过“我的帐户设置”选择收到各站点的挂起电子邮件。

恢复挂起的订阅

管理员和订阅所有者可通过以下几种方式恢复订阅:

  • 通过“内容设置”中的“我的订阅”选项卡

  • 通过每个工作簿的“订阅”选项卡

  • 通过“任务”下的“订阅”选项卡(仅限服务器管理员)

订阅恢复之后,通知失败计数将恢复为零。下一次订阅评估将在下次计划的评估时进行。

无法将订阅频率设置为“数据刷新时”

如果工作簿使用已发布数据提取连接,则可以将订阅设置为在数据提取刷新时运行。创建或修改订阅时,如果工作簿使用以下各项,则您可能不会看到“频率”选项:

  • 多个数据提取刷新

  • 实时数据连接

订阅没有到达(“发送电子邮件时出错。无法向 SMTP 主机发送命令。”)

如果订阅未到达,并且您的 SMTP 服务器使用的是加密 (TLS) 会话,则您可能会在 Windows 事件查看器中看到以上错误。若要将订阅发送到配置了 TLS 的 SMTP 服务器,必须在 Tableau Server 上配置安全的 SMTP。请参见配置 SMTP 设置。(如果遇到此错误,请注意 Tableau Server 将仍然会指明订阅正在“非数据提取后台任务”(链接在新窗口中打开)管理视图中发送。)

缺少数据质量警告

在以下情况下,订阅电子邮件中包含数据质量警告:

  • Tableau Server 或 Tableau Online 通过数据管理加载项获得许可。有关详细信息,请参见关于数据管理加载项

  • Tableau Catalog 已启用。有关详细信息,请参见启用 Tableau Catalog

  • 在站点设置中,已选中“订阅中的数据质量警告”下的复选框。

升级到 8.1 后,自定义脚本不工作

为了更好地管理会话,从 8.1 版开始,向视图 URL 末尾添加了一个井号 (#)。如果您的自定义订阅脚本会以 PDF 或 PNG 形式生成视图,可能需要更新脚本以允许使用井号。

例如,在版本 8.1 之前,视图 URL 使用此语法:http://tableauserver/views/SuperStore/sheet1。若要以 PNG 格式生成视图,可以将 .png 添加到 URL 末尾。例如,http://tableauserver/views/SuperStore/sheet1.png

在版本 8.1、8.2 或 8.3 中,视图 URL 使用此语法:http://tableauserver/views/SuperStore/sheet1#1。若要生成 PNG,请在井号标记前面添加 .png。例如:http://tableauserver/views/SuperStore/sheet1.png#1

升级到 9.0 后,自定义脚本不工作

在版本 9.0 中,服务器 URL 末尾的会话 ID 由“iid” 参数 :iid= 指明。例如,http://localhost/#/views/Sales2015/SalesMarginsByAreaCode?:iid=1。此参数替换了 Tableau Server 8.x 版本用于会话 ID 的井号标记“#”。

如果使用以 PDF 或 PNG 形式生成视图的自定义订阅脚本,您可能需要通过移除井号标记和数字 (#) 并在数字前面插入 ?:iid= 会话 ID 参数来更新脚本。

从版本 9.0 开始,视图 URL 使用此语法:http://tableauserver/views/SuperStore/sheet1?:iid=2

若要在版本 9.0 及更高版本中生成 PNG,请在会话 ID 前面添加 .pnghttp://tableauserver/views/SuperStore/sheet1.png?:iid=2