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分检测一次,则每天的整点时刻都会执行检测。
注:如果使用了抽数缓存,当检测频率大于数据更新频率,会提示“当前检测频率过高,底层数据更新不及时”,建议选择低频的检测。
「图表类型」:对组合图创建预警任务时,需要选择创建预警任务的图表类型。
「分类」:选择图表中的数据分类。
「系列」:选择图表中的数据系列。
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. 下一步编辑
数据预警插件安装及示例请参考:数据预警插件使用示例