历史版本27 :定时调度 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 应用场景

企业用户可能面临这样的情况,报表是需要定期生成、定期发布的,不得不定期做重复的事情来得到用户需要的报表。

1.2 功能介绍

FineReport 的定时调度功能可以让用户从不厌其烦的重复操作中解脱,可以方便快捷地设置日报、月报、季报、年报等任务,无需额外工作,定时任务设定后服务器便会在指定的时间自动完成设定的任务,生成所需的文件,甚至可以将生成的结果以邮件、短信、平台消息通知的方式通知用户,让用户及时的进行分析与决策。

2. 操作方法编辑

2.1 设置入口

定时调度的设置入口有两个,分别为:
1)定时器( op=fs )

进入决策系统,选择管理系统>定时调度,即可进入定时调度的设置界面。

Snag_8d3dce7.png

2)定时器(独立 timer)

如果不想通过决策系统来设置定时任务,也可以访问http://localhost:8075/webroot/decision/timer直接进入设置页面。详情参见文档:timer直接定时调度

2.2 任务管理

任务管理界面可以新建、修改、删除定时调度任务。有关创建定时调度任务的详细步骤可以参见文档:定时调度任务详细设置步骤

新建完成的定时调度任务会按列表显示在任务管理面板,可执行的管理操作包括:执行一次、编辑、复制、查看和删除。

注:无调度对象类型的定时调度任务显示在列表中时,使用模板下显示的是- -。

Snag_99ea9f4.png

2.3 运行监控

运行监控类似于日志,可以记录定时调度任务运行的简略信息。

Snag_9a1dda8.png

2.4 查看附件

定时调度任务执行完毕后,生成的附件会默认保存到%FR_HOME%\webapps\webroot\WEB-INF\schedule路径下。

Snag_9af7dc1.png

2.5 全局设置

运行失败提醒,包括短信、平台通知、邮件,提醒里包含任务名称和运行失败的时间。

点击定时调度页面左上方的全局设置按钮,即可设置运行失败提醒信息。

提醒方式包括:短信、平台通知、邮件。提醒内容是任务名称和运行失败的时间。

Snag_9a77b86.png

注1:失败提醒,若设置了重启,当重启成功时就不发信息了,只有重启依然失败才发出消息。

注2:开启短信功能参见文档: 短信 ,配置邮箱服务参见文档: 邮箱 

当定时任务运行失败时,会发送运行失败提醒,如下图所示:

短信提醒:

222

平台消息:

1572424126243434.png

邮件提醒:

1572423687419507.png

3. 执行过程编辑

  • 定时任务执行过程流程图如下图,定时任务开始时,首先进行条件判断,判断为真则生成快照,判断为假则确定是否设置了重启,如果设置了重启,则延时重新开始定时任务,又重新开始进行条件判断,没设置任务重启,则直接结束定时任务。

  • 生成快照成功则进入附件发送,失败则判断是否设置任务重启,设置了就重新进入条件判断,没设置则结束定时任务。

  • 附件发送成功就可以结束定时任务,如果发送失败暂时也只能直接结束定时任务。
    222

注:定时任务中的条件判断、生成快照和附件发送如果失败则都需要进行判断是否设置了任务重启。

4. 注意事项编辑

4.1 注意事项一

问题描述:JAR 包为 2019-12-05 及之后的 FineReport 设计器,在其决策平台上创建「无调度对象」类型的任务后,如果再将 JAR 包回退到 2019-12-05 之前,便会报下面所描述的错误。

数据决策系统中,点击管理系统>定时调度后,立刻报错「请求服务器数据失败」,且定时调度任务列表显示为空;

同时后台日志报错 java.lang.IllegalArgumentException: Non-existent schedule extension modules,如下图所示:

1572425916236843.png

21.png

原因分析:该现象是因为出现了兼容性问题,这种情况下任务正常执行,但任务列表无法正常显示。

解决方案:需要下载「云端运维-定时调度脏数据删除插件」,自动检查并删除/提示删除脏数据。

注:本文暂不提供下载链接,请需要的客户联系技术支持获取。

插件使用方法:

1)访问平台下的/url/clean,如 http://ip:port/webroot/decision/url/clean。如下图所示:

1572427064883317.png

2)提示找到了无调度对象的定时调度任务,名字为「工资表」,共计 1 个,点击下面的链接即可删除该任务,如下图所示:

1572427197146227.png

4.2 注意事项二

问题描述:

JAR 包为 2019-09-27 之后的 FineReport 设计器,在其决策平台上新建定时调度任务,如果再将 JAR 包回退到之前版本(2019-05-20 至 2019-09-27,包括 2019-09-27 ),不重新执行此定时调度任务查看之前执行时挂载的结果链接,图表不可见,如下图所示:

13.png

解决方案:已回退到的版本再次执行此任务,生成新结果链接,可查看图表。

注:不建议用户回退,由于版本间不向上兼容,回退后可能会出现一些问题。

5. 索引编辑

序号简介参考文档
1定时调度任务设置时四个操作步骤的详细介绍定时调度任务详细设置步骤
2定时任务完成后将结果以短信形式发送给收信人定时任务发送短信通知
3定时任务完成后将结果以邮件形式发送给收件人定时任务发送邮件
4定期给不同的人发送不同内容邮件定时任务邮件发送实现不同的人发送不同内容
5在每天生成固定某个时间段的数据,这些数据以 PDF、WORD、CPT、XLS 等格式保存在对应的目录当中定时任务简单示例之日报
6每月在固定某个时间段统计各个分公司的销售业绩,或在年底统计各个分公司的销售业绩,这些数据可以以 PDF、WORD、CPT、XLS 等格式保存在自己设定的目录当中,进而备份数据定时任务之月报与年报
7定时实现数据的加载、汇总、填入库等操作定时填报
8客户不需要使用决策系统,仍可使用定时调度这个功能timer 直接定时调度
9定时调度任务执行后生成的结果报表介绍
定时任务结果报表
10每个用户只看到自己信息,例如,定时的在每个月月底,用户查看自己工资定时任务cpr文件内容权限控制