1. 预警的概述

预警，是当卡片内维度或数值达到某一设定的条件时，平台第一时间告知用户数据异常的信号。该功能可以帮助用户及时做出决策、反馈。资源的所有者可设置预警，预警的接收方式可以为邮件、企业微信、钉钉、飞书、泛微OA、云之家等消息推送。预警支持周期执行或数据更新后执行。

2. 卡片预警

2.1 创建预警

第一步，点击卡片右上角“...”按钮，选择“预警”。

第二步，点击“新建预警”来添加您的预警，单个卡片最多能添加20个预警（默认状态下，卡片没有预警）。

2.2 配置预警

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

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

时间宏在预警名称里能否正常显示？

3）规则（必填）：预警规则决定了预警触发的条件。观远数据支持简单到复杂，单一到复合的各种形式预警规则。

• 一条预警：可包含一个或多个预警规则。

• 一条预警规则：包含“维度”和“数值”两方面条件。

• 多条预警规则：可选择“满足所有规则”或“满足任一规则”触发条件。

创建预警时，想要设置某字段大于某个数值时触发预警，该怎么设置？

卡片创建预警时，范围里没有可以选择的快捷日期，比如“昨天”？

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

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

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

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

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

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

7）收件人：

• 外部邮箱：当管理后台配置「允许发送至系统外用户」时，支持发送到邮箱。请进入「管理中心 > 系统管理 > 高级设置」，在通用页面的「订阅预警参数设置」区域，打开「是否允许发送至系统外用户」开关并配置允许的邮箱后缀。

• 用户/用户组：观远BI的单个用户或用户组，必须配有观远账号。当预警触发时，系统会向该注册用户的登记邮箱发送一封预警触发邮件。

「通知渠道」选择邮件时，除了支持收件用户，还支持密送用户和抄送用户，密送用户之间互相看不到收件信息，抄送用户无需对订阅进行答复和批复。此外，用户还可批量添加预警邮件的收件人与抄送人，并对其进行顺序调整，具体的操作配置和订阅相似，可参考《订阅》 小节中的介绍。

8）通知标题：为该预警创建通知标题；如未填写，则默认标题。

9）通知内容：预警配置与订阅一致，详见订阅动态参数说明。

10）图片内容：支持插入卡片图片。

11）通知跳转链接：支持“显示”或“隐藏”卡片详情页链接，对于邮件渠道支持用户自定义邮件正文并单独设置跳转链接。

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

2.3 预警中心

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

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

3. 数据集预警

3.1 创建预警

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

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

3.2 配置预警

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

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

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

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

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

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

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

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

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

7）通知渠道（必填）：支持邮件、企业微信、钉钉、云之家、泛微、飞书等多种通知渠道。其中企业微信、钉钉、云之家、飞书支持以点对点“消息通知”方式发送预警。

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

• “固定值”分发规则：

• 当属性值为单值时，如多选，此时，如姓名（用户属性）固定值 多选小A，小B，则姓名等于小A或小B的两个账号作为收件方；

• 当属性值为多值时，如多选，此时，如区域（用户属性）固定值 多选北京、上海，则区域包含北京或上海的账号作为收件方。

数据集有两个邮箱字段，创建数据集预警的时候，收件人分发条件都选了，预警显示已触发，但是收不到邮件是怎么回事？

支持根据收件人合并发送消息，数据集预警命中数据行按收件人分发，即一个收件人收到包含与自己相关的全部数据行的一个消息，以下是配置方法及效果。

注意：

默认每个人最多收到 20 行数据，如超过限制需发送可联系观远运维同学修改配置扩大观远侧行数限制guandata.noticeReferenceCountLimit。

以邮件渠道为例，配置数据集预警：

发送邮件效果：

9）通知标题：为该预警创建通知标题；如未填写，则默认标题。

10）通知内容：填写通知正文；如未填写，则默认正文。在编辑邮件正文的时候，支持添加字段，这样每个收件人收到的信息根据收件人的不同可以动态变化。同时，如果插入的是数值字段，还支持对数据进行数据格式设置，以便提供更好的阅读体验（如完成进度的小数设置为百分比）。

11）图片内容：支持插入卡片图片。

12）通知跳转链接：支持“显示”或“隐藏”卡片详情页链接。

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

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 中，权限与角色相关联，用户通过成为适当角色的成员而得到这些角色的权限。

具体权限及表现对应关系：

特别注意

• 如新增预警，创建者后续失去导出权限，则预警会报错。

5. 预警相关文档

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

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