1.场景
FineReport/FineBI中,用户在制作组件时,经常对数据异常值进行分析,从而指导业务的发展。但是人工发现异常值的效率过低,于是往往会应用“定时调度”功能让服务器在指定的时间自动完成设定的任务,比如组件预警(异常值提醒)就是“定时调度”可以实现重要场景之一。
数知鸟集成FineReport/FineBI的定时调度功能,实现将提醒自动生成需求、变更字段、新增备注等场景,从而进一步完善预警需求处理的闭环。
注:使用前提条件为安装数知鸟插件,且插件版本为10.0.45及以上
| 视频教程(建议观看)
2.FineReport/FineBI集成设置
2.1创建测试定时调度任务
管理员登陆后,在「管理系统」>「定时调度」>「添加任务」,配置【基本设置】、【调度对象】、【调度周期】、【文件处理】(具体可见帮助文档),文件处理方式选择“推送到数知鸟”,“webhook地址”参考帮助文档。
注1:此步骤【调度对象】中可选择目标模版
注2:此步骤【调度周期】中需设置一个必将触发的预警条件(例如,模版中已知某客户合同金额为2000,那预警条件可设置为0<合同金额<5000),这样触发定时调度、从而在2.2中了解请求格式与内容
注3:此步骤【文件处理】中处理方式选择为“推送到数知鸟”,并在此页面“Webhook地址”中填入帮助文档中地址
2.2了解请求结构与内容
具体操作可见帮助文档,发现关键信息处于请求中的body结构中,具体信息如下
注:此步骤用于获取关键信息、在3.2中建立动态数据映射
请求示例:
{ "outputFiles": [ "schedule/浙江销售额异常提醒/2022-12-13/1811/通用结果/销售额分析表.widget" ], "creator": "shuzhiniao", "support_finish_namespace": true, "recordList": [ { "type": "param", "value": "{\"id\":\"18f2e60e27c29902\",\"fieldName\":\"地区数据分析.合同金额\",\"fieldId\":\"地区数据分析_[603b][91d1][989d]\",\"filterType\":50,\"filterValue\":{\"min\":\"80000\",\"max\":\"\",\"closeMin\":true,\"closeMax\":false},\"value\":50,\"nameValid\":true}" } ], "_same_fire_": "浙江销售额异常提醒_same_fire_1670926265583", "actorNameMap": null, "actorName": "page", "outputFileMap": null, "saveDirectory": "schedule/浙江销售额异常提醒/2022-12-13/1811/通用结果", "taskType": 2, "output_record_success_log": true, "templateName": null, "pluginEmailSenderDisabled": null, "showType": "PAGE", "usernames": [], "taskName": "浙江销售额异常提醒", "details": [ { "taskType": 2, "warning_text": "省份 属于 [浙江省], 当前数据 : 浙江省<br>", "is_warning": true, "fireTime": "2022-12-13 18:11:09", "report_id": "f9ef403ac42a4391a3992dc889015f17", "taskName": "浙江销售额异常提醒", "username": "", "resultLink": "http://124.70.107.171:8092/web11dev/decision/v5/design/report/f9ef403ac42a4391a3992dc889015f17/view" } ], "saveDirectoryWithoutUsername": "schedule/浙江销售额异常提醒/2022-12-13/1811/$username_in_path", "username": "", "output_record_success_detail": ""}
重要请求参数:
参数 | 说明 |
---|---|
taskName | 定时调度任务名称 |
details[0].warning_text | 预警数据,包括定时调度设置的预警要求与当前数据 |
details[0].resultLink | 报表链接地址 |
3.数知鸟集成设置
3.1新增“集成服务”
「设置」>「集成配置」>「集成服务」,新增集成、设置集成名称。
3.2配置“集成服务”
1)设置动态数据映射
将2.2中了解到的关键信息添加为动态数据映射,便于固化应用于其他步骤
2)在webhook卡片中设置集成服务作用空间
3)添加“新增需求”步骤并配置
设置提出人、需求类型、标题及详情
4)保存
4.创建正式定时调度任务
重复步骤2.1、新建定时调度任务,不同的是该定时调度任务【文件处理】步骤“webhook地址”需填入3.1数知鸟新建集成服务中【收到webhook】卡片中“webhook地址”
5.检验
在集成服务列表中,可点击查看具体运行情况,了解是否成功运行
6.执行效果
空间内新增需求,需求类型为“需求新增”、标题为“浙江销售额异常提醒”、详情为“预警数据和报表地址”