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

全部填写完毕后点击“确定”，即可生成预警。

2.3 预警中心

第一步，导航栏右侧的九宫格，进入预警中心。

第二步，进入当前用户所有相关预警的管理界面。普通用户可以管理其所拥有的所有页面相关的预警；管理员可管理该域内所有预警。

3. 数据集预警

3.1 创建预警

第一步，点击右上角九宫格，选择“预警中心”。

第二步，点击“数据集预警”-“添加预警”，进入数据集预警的设置界面。

3.2 配置预警

1）启用预警：选择是否开启该预警。

2）预警名称（必填）：为该预警创建名称，从而便于在预警中心快速找到该预警。同时一个恰当的名字，可以让您在收到预警邮件时，快速理解出现的问题，比如“华东区门店销售额未达预期”。

3）数据集：选择关联的数据集，需要用哪个数据集的信息进行预警。

4）规则（必填）：设置什么情况下触发预警。

5）触发时间（必填）：可选择“数据更新后”或“定时执行”。

数据更新后：每当卡片数据更新时，触发预警检测，一旦满足预警条件，则邮件通知相关用户。

定时执行：可选择每天、每周、每月定时检测预警，并在满足预警条件时邮件通知相关用户。

6）有效期（必填）：可选择“长期有效”或“时间范围内有效”。

时间范围内有效：可设置从开始到结束的日期，若不设置，默认为长期有效。

7）通知渠道（必填）：支持邮件、企业微信、钉钉、云之家、泛微、飞书等多种通知渠道。其中企业微信、钉钉、云之家、飞书支持以“消息通知”和“群机器人”的方式，发送预警。（更多群机器人内容详见《使用群机器人推送信息通知》）

8）收件人分发条件（必填）：因为数据集预警支持同一条规则每个人收到的具体信息各不相同，因此需要数据集中有相关字段与用户属性关联，当该条数据符合预警规则后，会根据这条信息对应的用户属性信息，发送给对应的人（详见下文中的举例）。

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. 预警相关文档

使用案例：《巧用预警推送卡片明细到个人》

常见问题：《订阅与预警常见功能》