1. 概述

提供了数据订阅与推送功能,可以选择在特定时间间隔(例如每周或每月)自动收到订阅的数据。

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


邮箱接收订阅的效果如下:

2. 配置业务模型订阅任务

2.1. 创建入口

进入业务模型详情页 - 更多 - 新建订阅

(警告)仅限类型:结果表、外部表导入、自定义查询保存的业务模型

2.2. 基础信息

任务名称用于管理订阅任务,不会出现在正式推送的内容中
标题

将作为推送的标题展示

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

替换符代表含义举例
${date}发送时间的年月日

标题输入

本次推送 ${date}${hour}  ${resource_name} 内容


接收效果

本次推送 2023033010  Demo_2.5 内容

${hour}发送时间的小时
${resource_name}业务模型名称
正文

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

2.3. 订阅内容

根据业务模型的数据结构,选择部分字段进行明细数据的推送

  • 可按时间、维度、指标等字段进行筛选
  • 多个条件之间,仅支持「且」关系

可同时将Excel附件推送至邮件中

2.4. 通知设置

发送时间

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

  • 每小时:最多支持 4 个时间点,分别是 00 分、15 分、30 分、45 分
  • 每天:同一任务,可在每天的多个小时执行
  • 每周:同一任务,可在每周的任意一天、某个固定时刻执行
  • 每月:同一任务,可在每月的任意一天、某个固定时刻执行
推送方式 - 邮件

1. 发件地址

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

2. 收件地址

可输入多个邮箱(回车完成一个邮箱输入)

2.5. 异常处理配置

2.5.1. 数据就绪检测

谨慎开启:

  • 仅适用于 业务模型更新延迟较高、可能晚于订阅时间时,可开启此配置


检测通过标准:

  • 执行订阅的此时此刻、对应的业务模型在当前周期内,更新成功过(包括手动更新成功)
场景 1: 业务模型每天 06:00 更新

订阅 04:00 执行时

昨天 06:00 ~ 今天 06:00 之间,业务模型更新成功过,则检测通过

订阅 10:00 执行时

今天 06:00 ~ 明天 06:00 之间,业务模型更新成功过,则检测通过

场景 2: 业务模型每周三 06:00 更新

订阅本周二执行时

上周三~本周三之间,业务模型更新成功过,则检测通过

订阅本周四执行时

本周三~下周三之间,业务模型更新成功过,则检测通过

场景 4: 业务模型每月 3 日更新

订阅本月 1 日执行时

上月 3 日~本月 3 日之间,业务模型更新成功过,则检测通过

订阅本月 5 日执行时

本月 3 日~下月 3 日之间,业务模型更新成功过,则检测通过

检测范围:

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

就绪等待:

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

2.5.2. 超时提醒

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

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

2.5.3. 失败通知

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


3. 测试发送

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

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


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


4. 管理报表订阅任务

4.1. 管理列表入口

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

入口 2:业务模型详情页 -> 更多 -> 管理订阅,可跳转至对应资源的订阅管理页面


4.2. 任务操作

操作类型功能描述示意
查看日志

可查看任务每次执行过程的日志信息

  • 在列表中,可快速查看最新一次执行的日志
  • 在发送记录中,可查看历史记录的日志

重新发送

手动发起一次当前周期的任务执行

适用于订阅失败、并解决相关问题后,再次尝试发送

关闭任务关闭任务的调度,但仍保留任务的配置和历史运行记录

复制任务复制当前任务的配置、创建一个新的订阅任务 ID
删除任务删除任务后,不可恢复、历史记录也会被清空,谨慎操作(警告)

5. 订阅权限控制

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

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

权限回收影响

管理者收敛权限后,使用者的订阅任务将 自动 停止调度,即任务状态变更为 “已关闭”
个人空间仅报表的创建人、管理者,可订阅