菜单

订阅报表

概述

报表提供了图表订阅与数据推送功能，可以选择在特定时间间隔（例如每周或每月）自动收到订阅的报表和数据。

借助订阅能力，可通过邮件、IM 等途径直接推送关键指标数据，实现管理层、业务层对数据近况的密切跟进。
支持订阅任务管理，通过协同实现多人可协同编辑、共同维护。
提供清晰可读的日志信息，可以快速定位任务状态、失败原因。

接收订阅的效果如下：

订阅内容	企业微信接收	邮件接收
整张报表
部分图表		/

配置报表订阅任务

创建入口

进入报表预览页面 > 更多 > 新建订阅

基础信息

任务名称

用于管理订阅任务，不会出现在正式推送的内容中

标题

将作为推送的标题展示，一般以报表名称 + 时间命名

支持在标题中直接输入替换符，用来展示动态的获取参数内容，比如时间、报表名称等

替换符

代表含义

举例

${date}

发送时间的年月日

标题输入：

本次推送 ${date} ${hour} 的 ${dashboard_name} 内容

接收效果：

本次推送 20230330 10 的 Demo_2.5 内容

${hour}

发送时间的小时

${dashboard_name}

报表名称

正文

订阅的内容区，一般用于做报表推送内容的文字辅助说明

订阅内容

订阅整张报表	将以截图形式，发送整张报表附件可选项： PDF 图片：将报表截图以 PDF 文件格式，发送至推送消息中 Excel 数据：可选择有进一步分析诉求的图表，下载其数据，按需配置 Excel 文件的合并方式
订阅部分图表	仅发送所选图表的截图附件可选项： Excel 数据：可选择订阅范围内的 N 个图表，下载其数据

订阅整张报表

将以截图形式，发送整张报表

附件可选项：

PDF 图片：将报表截图以 PDF 文件格式，发送至推送消息中
Excel 数据：可选择有进一步分析诉求的图表，下载其数据，按需配置 Excel 文件的合并方式

订阅部分图表

仅发送所选图表的截图

附件可选项：

Excel 数据：可选择订阅范围内的 N 个图表，下载其数据

通知设置

发送时间	按特定频率、在特定时间点，运行订阅任务每小时：最多支持 4 个时间点，分别是 00 分、15 分、30 分、45 分每天：同一任务，可在每天的多个小时执行每周：同一任务，可在每周的任意一天、某个固定时刻执行每月：同一任务，可在每月的任意一天、某个固定时刻执行
推送方式 - Webhook	支持通过 Webhook 向飞书、钉钉、企业微信等企业群发送通知可下拉选择多个配置完成的企业群如果没有可用的 Webhook，可点击文字按钮，跳转新页面、创建 Webhook【如何设置企业群通知，详见如何配置企业群通知】注意事项 Webhook 功能有 license 控制，需要先开启且当前用户角色有对应使用权限、才可使用如果您的 SA 环境只能内网访问，那么通过 Webhook 发送的图片也只能通过内网打开邮件通知
推送方式 - 邮件	1. 发件地址邮件的发件地址默认会读取「发件箱管理」的邮件地址，可点击“设置”图标快速进入发件箱管理目前会按照个人邮箱 > 项目邮箱 > 平台邮箱的优先级顺序来获取发件地址 2. 收件地址可输入多个邮箱（回车完成一个邮箱输入）

发送时间

按特定频率、在特定时间点，运行订阅任务

每小时：最多支持 4 个时间点，分别是 00 分、15 分、30 分、45 分
每天：同一任务，可在每天的多个小时执行
每周：同一任务，可在每周的任意一天、某个固定时刻执行
每月：同一任务，可在每月的任意一天、某个固定时刻执行

推送方式 - Webhook

支持通过 Webhook 向飞书、钉钉、企业微信等企业群发送通知
可下拉选择多个配置完成的企业群
如果没有可用的 Webhook，可点击文字按钮，跳转新页面、创建 Webhook【如何设置企业群通知，详见如何配置企业群通知】

注意事项

Webhook 功能有 license 控制，需要先开启且当前用户角色有对应使用权限、才可使用

如果您的 SA 环境只能内网访问，那么通过 Webhook 发送的图片也只能通过内网打开邮件通知

推送方式 - 邮件

1. 发件地址

邮件的发件地址默认会读取「发件箱管理」的邮件地址，可点击“设置”图标快速进入发件箱管理
目前会按照个人邮箱 > 项目邮箱 > 平台邮箱的优先级顺序来获取发件地址

2. 收件地址

可输入多个邮箱（回车完成一个邮箱输入）

异常处理配置

数据就绪检测

谨慎开启：

仅适用于业务模型更新延迟较高、可能晚于订阅时间时，可开启此配置
开启就绪检测后，每次执行订阅前，都会检查当前周期的业务模型是否“更新成功过”
- 如成功，则继续执行订阅
- 如尚未成功，将一直等待最多 6 小时，6 小时内任意时间点成功、则继续执行；否则任务失败

检测通过标准：

执行订阅的此时此刻、对应的业务模型在当前周期内，更新成功过（包括手动更新成功）

场景 1: 业务模型每天 06:00 更新	订阅 04:00 执行时	昨天 06:00 ~ 今天 06:00 之间，业务模型更新成功过，则检测通过
场景 1: 业务模型每天 06:00 更新	订阅 10:00 执行时	今天 06:00 ~ 明天 06:00 之间，业务模型更新成功过，则检测通过
场景 2: 业务模型每周三 06:00 更新	订阅本周二执行时	上周三 ~ 本周三之间，业务模型更新成功过，则检测通过
场景 2: 业务模型每周三 06:00 更新	订阅本周四执行时	本周三 ~ 下周三之间，业务模型更新成功过，则检测通过
场景 3: 业务模型每月 3 日更新	订阅本月 1 日执行时	上月 3 日 ~ 本月 3 日之间，业务模型更新成功过，则检测通过
场景 3: 业务模型每月 3 日更新	订阅本月 5 日执行时	本月 3 日 ~ 下月 3 日之间，业务模型更新成功过，则检测通过

检测范围：

开启就绪检测后，当报表中所有业务模型通过就绪检测、任务才会继续执行

就绪等待：

开启就绪检测后，会在 6 个小时内持续检测“是否所有业务模型均已就绪”
在 6 个小时内的任意时刻，所有业务模型通过检测、则继续执行
超过 6 小时、仍有部分业务模型未就绪，则判定任务执行失败，向失败通知地址发送通知

超时提醒

可以理解为“闹钟”的作用：

从订阅执行的时间点开始计算，如果 N 个小时后、订阅仍未成功发送，则会向 失败通知 的地址发送提醒消息
消息仅做提醒作用，不会影响任务继续运行
可引导相关人员提前介入排查，检查相关业务模型的更新状态、或其他可能会影响订阅的配置

失败通知

未填写时，将默认向“创建订阅的用户”发送任务失败相关的消息通知

测试发送

用于确保订阅可以正常发送、且数据内容正确

测试发送的收件地址，区别于正式的地址，可在小范围内进行收件测试、共同 Check 数据，无需调整收件人列表

需要注意的是，测试发送不会保存本次修改的订阅配置，如果测试结果符合预期，一定要点击“保存”，以免配置丢失

管理报表订阅任务

管理列表入口

入口1：可视化 > 管理中心 > 订阅，进入报表/业务模型的订阅管理

入口2：报表的预览页 > 更多 > 管理订阅，可跳转至对应资源的订阅管理页面

任务操作

操作类型	功能描述	示意
查看日志	可查看任务每次执行过程的日志信息在列表中，可快速查看最新一次执行的日志在发送记录中，可查看历史记录的日志
重新发送	手动发起一次当前周期的任务执行适用于订阅失败、并解决相关问题后，再次尝试发送
关闭任务	关闭任务的调度，但仍保留任务的配置和历史运行记录
复制任务	复制当前任务的配置、创建一个新的订阅任务 ID
删除任务	删除任务后，不可恢复、历史记录也会被清空，谨慎操作

订阅权限控制

所在空间	用户权限	对应的订阅权限
公共空间	有报表 A 的管理权限	可创建报表 A 的订阅任务可管理所有人基于报表 A 创建的订阅任务对订阅任务增删改查围绕订阅任务进行跟进维护，包括看日志、终止调度、重新发送等可配置「订阅权限」，如下图
有报表 A 的查看权限	默认可创建报表 A 的订阅任务如果报表的管理者收敛了订阅权限，变更订阅权限为“仅报表管理者可订阅”，则使用权限不可订阅权限回收影响管理者收敛权限后，使用者的订阅任务将自动停止调度，即任务状态变更为“已关闭”
个人空间	仅报表的创建人、项目管理员、超级管理员，可订阅

所在空间

用户权限

对应的订阅权限

公共空间

有报表 A 的管理权限

可创建报表 A 的订阅任务
可管理所有人基于报表 A 创建的订阅任务
- 对订阅任务增删改查
- 围绕订阅任务进行跟进维护，包括看日志、终止调度、重新发送等
可配置「订阅权限」，如下图

有报表 A 的查看权限

默认可创建报表 A 的订阅任务
如果报表的管理者收敛了订阅权限，变更订阅权限为“仅报表管理者可订阅”，则使用权限不可订阅

权限回收影响

管理者收敛权限后，使用者的订阅任务将自动停止调度，即任务状态变更为“已关闭”

个人空间

仅报表的创建人、项目管理员、超级管理员，可订阅

上一个

分享与应用

下一个

订阅业务模型

最近修改: 2025-03-10