预警
1. 预警的概述
预警,是当卡片内维度或数值达到某一设定的条件时,平台第一时间告知用户数据异常的信号。该功能可以帮助用户及时做出决策、反馈。资源的所有者可设置预警,预警的接收方式可以为邮件、企业微信、钉钉、飞书、泛微OA、云之家等消息推送。预警支持周期执行或数据更新后执行。
2. 卡片预警
2.1 创建预警
第一步,点击卡片右上角“...”按钮,选择“预警”。
第二步,点击“新建预警”来添加您的预警,单个卡片最多能添加20个预警(默认状态下,卡片没有预警)。
2.2 配置预警
1)启用预警:选择是否开启该预警。
2)预警名称(必填):为该预警创建名称,从而便于在预警中心快速找到该预警。同时一个恰当的名字,可以让您在收到预警邮件时,快速理解出现的问题,比如“华东区门店销售额未达预期”。
3)规则(必填):预警规则决定了预警触发的条件。观远数据支持简单到复杂,单一到复合的各种形式预警规则。
一条预警:可包含一个或多个预警规则。
一条预警规则:包含“维度”和“数值”两方面条件。
多条预警规则:可选择“满足所有规则”或“满足任一规则”触发条件。
创建预警时,想要设置某字段大于某个数值时触发预警,该怎么设置?
卡片创建预警时,范围里没有可以选择的快捷日期,比如“昨天”?
4)触发时间(必填):可选择“数据更新后”或“定时执行”。
数据更新后:每当卡片数据更新时,触发预警检测,一旦满足预警条件,则邮件通知相关用户。
定时执行:可选择每天、每周、每月定时检测预警,并在满足预警条件时邮件通知相关用户。
5)有效期(必填):可选择“长期有效”或“时间范围内有效”。
时间范围内有效:可设置从开始到结束的日期,若不设置,默认为长期有效。
6)通知渠道(必填):支持邮件、企业微信、钉钉、云之家、泛微、飞书等多种通知渠道。其中企业微信、钉钉、云之家、飞书支持以“消息通知”和“群机器人”的方式,发送预警。(更多群机器人内容详见《使用群机器人推送信息通知》)
7)收件人:收件人可为单个用户或用户组,但必须配有观远账号,当预警触发时,系统会向该注册用户的登记邮箱发送一封预警触发邮件。选择邮件时,除了支持收件用户,还支持密送用户和抄送用户,密送用户之间互相看不到收件信息,抄送用户无需对订阅进行答复和批复。此外,用户还可批量添加预警邮件的收件人与抄送人,并对其进行顺序调整,具体的操作配置和订阅相似,可参考《订阅》 小节中的介绍。
8)通知标题:为该预警创建通知标题;如未填写,则默认标题。
9)通知内容:预警配置与订阅一致,详见订阅动态参数说明。
10)图片内容:支持插入卡片图片。
11)通知跳转链接:支持“显示”或“隐藏”卡片详情页链接,对于邮件渠道支持用户自定义邮件正文并单独设置跳转链接。
通知渠道 | 图片内容 | 通知跳转链接 |
邮件 | 支持卡片图片 | 不支持跳转 |
企业微信 | 支持卡片图片 支持自定义上传图片:JPG、PNG格式,建议分辨率大小为:大图 1068*455,小图150*150 | 卡片详情页、卡片所属页面、卡片所属移动轻应用页面、仪表板页面、自定义、不跳转 |
钉钉 | 支持卡片图片 | 卡片详情页、卡片所属页面、卡片所属移动轻应用页面、仪表板页面、自定义、不跳转 |
云之家 | 不支持 | 卡片详情页、卡片所属页面、卡片所属移动轻应用页面、仪表板页面、自定义、不跳转 |
泛微 | 不支持 | 卡片详情页、卡片所属页面、卡片所属移动轻应用页面、仪表板页面、自定义、不跳转 |
飞书 | 支持卡片图片:需要开通飞书应用权限:“获取与上传图片或文件资源”或“上传文件V2” | 卡片详情页、卡片所属页面、卡片所属移动轻应用页面、仪表板页面、自定义、不跳转 |
全部填写完毕后点击“确定”,即可生成预警。
2.3 预警中心
第一步,导航栏右侧的九宫格,进入预警中心。
第二步,进入当前用户所有相关预警的管理界面。普通用户可以管理其所拥有的所有页面相关的预警;管理员可管理该域内所有预警。
3. 数据集预警
3.1 创建预警
第一步,点击右上角九宫格,选择“预警中心”。
第二步,点击“数据集预警”-“添加预警”,进入数据集预警的设置界面。
3.2 配置预警
1)启用预警:选择是否开启该预警。
2)预警名称(必填):为该预警创建名称,从而便于在预警中心快速找到该预警。同时一个恰当的名字,可以让您在收到预警邮件时,快速理解出现的问题,比如“华东区门店销售额未达预期”。
3)数据集:选择关联的数据集,需要用哪个数据集的信息进行预警。
4)规则(必填):设置什么情况下触发预警。
5)触发时间(必填):可选择“数据更新后”或“定时执行”。
数据更新后:每当卡片数据更新时,触发预警检测,一旦满足预警条件,则邮件通知相关用户。
定时执行:可选择每天、每周、每月定时检测预警,并在满足预警条件时邮件通知相关用户。
6)有效期(必填):可选择“长期有效”或“时间范围内有效”。
时间范围内有效:可设置从开始到结束的日期,若不设置,默认为长期有效。
7)通知渠道(必填):支持邮件、企业微信、钉钉、云之家、泛微、飞书等多种通知渠道。其中企业微信、钉钉、云之家、飞书支持以点对点“消息通知”方式发送预警。
8)收件人分发条件(必填):因为数据集预警支持同一条规则每个人收到的具体信息各不相同,因此需要数据集中有相关字段与用户属性关联,当该条数据符合预警规则后,会根据这条信息对应的用户属性信息,发送给对应的人(详见下文中的举例)。
“固定值”分发规则:
当属性值为单值时,如多选,此时,如姓名(用户属性)固定值 多选小A,小B,则姓名等于小A或小B的两个账号作为收件方;
当属性值为多值时,如多选,此时,如区域(用户属性)固定值 多选北京、上海,则区域包含北京或上海的账号作为收件方。
注意:
以邮件渠道为例,配置数据集预警
发送邮件效果
9)通知标题:为该预警创建通知标题;如未填写,则默认标题。
10)通知内容:填写通知正文;如未填写,则默认正文。在编辑邮件正文的时候,支持添加字段,这样每个收件人收到的信息根据收件人的不同可以动态变化。同时,如果插入的是数值字段,还支持对数据进行数据格式设置,以便提供更好的阅读体验(如完成进度的小数设置为百分比)。
11)图片内容:支持插入卡片图片。
12)通知跳转链接:支持“显示”或“隐藏”卡片详情页链接。
通知渠道 | 图片内容 | 通知跳转链接 |
邮件 | 不支持 | 不支持跳转 |
企业微信 | 支持自定义上传图片:JPG、PNG格式,建议分辨率大小为:大图 1068*455,小图150*150 | 卡片详情页、仪表板页面、移动轻应用页面、自定义、不跳转 |
钉钉 | 不支持 | 卡片详情页、仪表板页面、移动轻应用页面、自定义、不跳转 |
云之家 | 不支持 | 卡片详情页、仪表板页面、移动轻应用页面、自定义、不跳转 |
泛微 | 不支持 | 卡片详情页、仪表板页面、移动轻应用页面、自定义、不跳转 |
飞书 | 不支持 | 卡片详情页、仪表板页面、移动轻应用页面、自定义、不跳转 |
全部填写完毕后点击“确定”,即可生成预警。
3.3 预警样例
可以看到,如果要进行数据集预警,对数据集的数据有一定的要求:
数据集里的数据,每一行必须包含当前预警规则所需信息,可以将数据集看做是一个发送列表。
数据集里必须包含至少一个用户属性字段,用以关联收件人。
举例说明:
如果希望能对未达到目标销售额的大区推送预警,那么此数据集无法直接使用,至少需要基于大区维度进行数据汇总,至少包含基于大区的销售额和目标销售额两个信息,生成最终可用于预警推送的数据集。
在观远中,您可以通过ETL来进行数据处理,如下图:
处理后的数据集如下(用户属性至少关联1个,此处为方便说明,关联了两个):
针对这个处理后的数据集,可以设置数据集预警。
例如,预警规则是当销售额小于销售额目标时触发,那么华北和华中会触发预警。
对于收件人:
Case1,收件人里关联的字段是大区id,那么该条信息会通知该大区id对应的所有用户(华北的信息会发送所有用户属性中大区id是B1002的用户,华中同理)。
Case2,收件人里管理的字段是大区经理工号,那么该条信息会通知该工号对应的用户(华北的信息会发送给用户属性中工号是bj0294的用户,华中同理)。
对于预警内容:
Case1,如果内容是“您所在的大区销售额未达标”,那么所有收件人收到的信息都是相同的文本信息。
Case2,如果内容是“你管理的区域销售额未达标:实际销售额是销售额;销售额目标是销售额目标(加粗代表是插入字段),则
华北的用户收到的信息是“你管理的区域销售额未达标:实际销售额是78283;销售额目标是80000”;
华中的用户收到的信息是“你管理的区域销售额未达标:实际销售额是45832;销售额目标是50000”。
4. 预警的权限限制
在新增了预警插入图片的功能后,会使得更多地方能够设置插入图片,为了保障数据安全,观远数据对于预警权限进行了优化,设置预警插入图片、附件控制导出权限。
使用说明
如“导出”权限控制开启,预警插入图片、附件则需校验创建者的RBAC导出权限和资源是否允许“导出”。
*RBAC 是基于角色的访问控制(Role-Based Access Control )在 RBAC 中,权限与角色相关联,用户通过成为适当角色的成员而得到这些角色的权限。
具体权限及表现对应关系:
功能 | 触达方式 | 权限限制 | 如不具有导出权限 |
卡片预警 | 邮件 | RBAC仪表板导出权限 &具有该仪表板导出权限 | 不可导出卡片图片 |
钉钉、飞书、企业微信 | RBAC仪表板导出权限 &具有该仪表板导出权限 | 不可导出卡片图片 | |
数据集预警 | 不限制 |
特别注意
如新增预警,创建者后续失去导出权限,则预警会报错。
5. 预警相关文档
使用案例:《巧用预警推送卡片明细到个人》
常见问题:《订阅与预警常见功能》