1. 概述编辑
1.1 版本
| 报表服务器版本 | 插件版本 | 功能变更 |
|---|---|---|
| 11.0.9 | 1.0.0 | - |
| 1.2.0 | 1）预警按钮变更为悬浮按钮。 2）支持的基础图表类型：饼图（不包含多层饼图）、柱形图、条形图、折线图、面积图、仪表盘、雷达图及以上图表的组合图。 3）所有的数值类型的单元格扩展出来的单元格均支持设置预警事件。 4）新增隐私设置方式，分别为「私密」和「公共」。 5）新增短信通知提醒方式。 6）新增支持决策报表。 | |
| 1.3.0 | 1）插件支持权限控制 2）接收人支持多选 3）检测频率支持明细设置，并支持设置多种检测频率 4）新增「指标历史汇总分析」功能 5）接收方式新增「平台通知」和「客户端通知」 注：「客户端通知」支持钉钉、飞书、企业微信、App通知，需要集成后才能使用。 | |
| 1.4.0 | 1）新增「生成预警待办」功能 2）新增「预警待办中心」，用于管理数据预警任务 | |
| 1.5.0 | 1）优化「创建预警」设置界面，拆分为三步：「基本设置」、「预警接收」、「更多设置」。 2）「基本设置」中，「触发条件」新增多种，包括：等于、不等于、大于等于、小于等于、介于、超出范围、为空、非空 3）「预警接收」中，「接收方式」的文本内容支持自定义编辑并引用变量。 4）根据选择的触发条件不同，在「我创建的预警」中，任务的历史趋势图展示不同的效果。 | |
| 1.5.2 | 「接收方式>邮件」中新增「其他内容」设置，可自定义接收内容为「结果链接」或「预警对象」 | |
| 1.5.3 | 1）数据预警界面UI优化 2）新增「动态接受人」功能，支持根据「用户」、「部门」、「角色」动态发生预警通知 |
1.2 应用场景
用户在使用 FineReport 报表进行数据展示的同时，也需要对异常数据进行日常监控。「数据预警插件」支持由业务用户在查看模板时自行创建数据监控预警，系统在发现异常时发送通知。数据预警插件与其他预警方式（定时调度/条件属性/警戒线功能）的价值差异点为：
1）数据找人节省时间：如某个数据需要每天监控并进行处理，但只有 10% 的概率会出现问题，业务人员如果每天查看条件属性/警戒线，那么一个月就有27天的查看是被浪费的。使用预警可以实现异常数据主动找人，用户可以根据理想的频率获知异常信息。
2）创建修改灵活自由：数据预警可以由业务用户随时创建，功能逻辑简洁，节省了和IT交流业务场景的时间，满足业务用户相对个性化的预警诉求。反之，如果一个预警/推送任务的业务场景已经固化且通用，表现为：面向很大的业务群体、对于推送的逻辑、推送的内容格式都有一定的要求，那么让IT人员配置定时调度任务是更为方便的选择。
2. 插件功能说明编辑
1）支持对数值类型的单元格扩展出来的单元格均支持设置预警事件，以及对图表设置预警事件。
注：支持的基础图表类型：饼图（不包含多层饼图）、柱形图、条形图、折线图、面积图、仪表盘及以上图表的组合图。
2）仅支持普通报表模式下的「填报预览」、「分析预览」、「分页预览」以及决策报表的「PC端预览」。
3）使用该插件的模板需要开启「模板认证」功能，并对相应的人员设置报表访问权限。同时需要开启「分级授权」功能，并在「普通权限配置」中对相关人员开通数据预警权限后才能使用。
4）数据预警任务支持邮件、短信、平台通知、客户端通知四种方式。
若通过邮件通知，数据决策系统邮箱需要配置默认发件人，否则将会出现提示：系统未配置发件人邮箱，保存失败。配置发件人邮箱可参考：邮箱 。
若通过短信通知，数据决策系统需要配置短信，否则将会出现提示：您的账号未绑定手机号。可参考：短信
客户端通知支持钉钉、飞书、微信、App通知四种方式，需要先进行集成后才可使用。
5）任务创建者和接收人需要绑定邮箱/短信，否则将会出现提示：您的账号尚未绑定邮箱/手机号，将无法收到通知。绑定邮箱可参考：用户设置 。
6）支持创建「生成预警待办」任务，对预警任务形成闭环管理，同时支持批量处理预警任务以及批量延期处理。
3. 插件安装编辑
4. 不同角色使用数据预警插件编辑
4.1 超管
1）超管需要将相关的报表挂载到数据决策平台后，安装插件后，并开启「模板认证」功能，对相应的人员设置报表访问权限。同时需要开启「分级授权」功能，并在「普通权限配置」中对相关人员开通数据预警权限后才能使用。
2）超管可在「管理预警任务>其他用户创建的预警」中可以相关任务的历史趋势图以及预览模板，或删除任务。如下图所示：
3）超管可以创建相关预警任务并通知相关人员，设置方式可参考 4.2 节。
4.2 任务创建者
超管完成相关配置后，拥有数据预警权限的用户在预览时报表界面时，右下角出现「预警」按钮 ，提示相关人员可创建预警任务。如下图所示：
点击「创建预警」按钮即可出现，创建预警的界面，在界面中可以「创建预警」任务并「管理预警任务」，如下图所示：
任务创建者可以管理已经创建的预警任务，当已经对表单创建了「预警事件」，可在界面对事件进行修改和删除。
4.2.1 创建预警任务
预警任务设置主要分为三部分：「基本设置」、「预警接收」、「更多设置」。
1）「基本设置」主要包括：「预警名称」，「触发条件」、「检测频率」、「通知频率」。若对图表创建预警任务则需要设置「图表类型」「分类」「系列」
「预警名称」：可以自定义预警任务名称。
「触发条件」：支持大于、小于、等于、不等于、大于等于、小于等于、介于、不介于、为空、不为空多种触发条件。
「检测频率」：支持设置多种检测频率，可选择每年/每月/每周/每天/每小时检测一次。如设置每小时00分检测一次，则每天的整点时刻都会执行检测。
「通知频率」：通知频率要大于检测频率，如设置每小时00分检测一次，则通知频率至少设置位1小时。
注：如果使用了抽数缓存，当检测频率大于数据更新频率，会提示“当前检测频率过高，底层数据更新不及时”，建议选择低频的检测。
「图表类型」：对组合图创建预警任务时，需要选择创建预警任务的图表类型。
「分类」：选择图表中的数据分类。
「系列」：选择图表中的数据系列。
2）「预警接收」主要包括：「接收人」和「接收方式」。
「接收人」：分为「指定接收人」和「动态接受人」。
| 接收人 | 详细说明 |
|---|---|
| 指定接收人 | 可以根据用户、部门、角色设置接收人，支持多选接收人。
|
| 动态接受人 | 可以根据用户、部门、角色设置接收人。
若部门名称是「技术支持」，那么会给所有的子节点（最下层节点）为「技术支持」的部门发送消息。 若部门的结构是「帆软-华东-技术支持」，那这个部门里的用户都会收到消息（技术支持是最下层的节点）。 若部门的结构是「帆软-华东-技术支持-技术支持A组」，仅「技术支持A组」可以收到消息。
注意事项：
|
注：用户创建预警时若需要选择其他角色作为接收人，需要管理员同时给用户开放对应角色的人员管理权限。
「接收方式」：支持邮件、短信、平台通知、客户端通知。支持自定义编辑，支持引用变量。
其中邮件支持「其他内容」设置，可选择「结果链接」或「预警对象」，结果链接将报表内容再邮件中显示为超链形式，预警对象将报表内容再邮件中显示为图片形式，默认为「结果链接」。
注：客户端通知支持钉钉、飞书、企业微信、App通知四种方式，需要先进行集成后才可使用。
| 变量名 | 变量值 |
|---|---|
| 预警名称 | ${taskName} |
| 所在模板 | ${templatePath} |
| 目录挂载名称 | ${displayName} |
| 触发条件 | ${ruleDescription} |
| 触发预警条数 | ${ruleMatchDataCount} |
| 触发预警最大值 | ${ruleMatchDataMax} |
| 触发预警最小值 | ${ruleMatchDataMin} |
3）「更多设置」主要包括：「隐私设置」和「预警待办」。
「隐私设置」：支持设置为公开或仅自己和接收人可见。
「预警待办」：预警触发之后会形成待办，发送给责任人进行处理，并设置触发预警后需要解决问题的时间。
注：超管需要为责任人开通数据预警权限后，责任人才能处理预警待办。
4.2.2 管理预警任务
任务创建者通过「管理预警任务」即可进入任务管理界面，可以进入「我创建的预警」、「我订阅的预警」、「预警待办中心」。
1）「我创建的预警」：可以查看任务的历史趋势图以及预览模板，或删除预警任务。其中历史趋势图根据触发条件不同展示不同的效果，如下表所示：
| 判断条件 | 展示内容 |
|---|---|
| 大于、小于 | 极值（包括极大值和极小值） |
| 等于、不等于 | 符合触发条件的数据个数 |
| 大于等于、小于等于 | 极值（包括极大值和极小值） |
| 介于、超出范围 | 极值（包括极大值和极小值） |
| 为空、非空 | 符合触发条件的数据个数 |
2）「我订阅的预警」：可以查看任务的历史趋势图以及预览模板，或取消订阅任务。
3）「预警待办中心」：可以查看相关待办的处理状态以及预计解决时间。
责任人的待办处理完成后，对应的待办在创建者的预警待办中心的消失。
正在处理的待办显示为处理中。
在预计解决时间内未处理完成的待办显示为延期。
注：为他人创建的待办，创建者不可进行处理或延期。
4.2.3 订阅预警任务
当 A 用户对某张报表创建的预警任务为公开任务时，B 用户拥数据预警权限且同时有查看该报表的权限时，可以在数据预警设置面板中，勾选「订阅」即可收到相关通知，如下图所示：
4.2.4 预警任务接收人
接收人可查看预警任务详情和创建人，接收人若拥有数据预警权限，对于接收的数据预警任务无法取消订阅，如下图所示：
4.2.5 预警待办责任人
预警待办责任人可以在「预警待办中心」查看待办的任务以及任务的相关状态，同时对任务进行处理，或延期并设置新的完成时间。
1）解决任务：点击解决按钮后，预警待办消失，支持批量解决任务，如下图所示：
2）延期任务：点击延期按钮后设置最晚完成时间，修改后待办的预计解决时间变更为新设置的时间，状态变更为处理中，支持批量延期任务，如下图所示：
5. 下一步编辑
数据预警插件安装及示例请参考：数据预警插件使用示例