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

目录:

1. 描述编辑

企业用户可能面临这样的情况,报表是需要定期产生、定期发布的,不得不定期的做同样的事情来得到用户要的报表。FineReport 的定时调度功能可以让用户从不厌其烦的重复操作中解脱,可以方便快捷的设置日报、月报、季报、年报等任务,无需额外工作,定时任务设定后服务器便会在指定的时间自动完成设定的任务,生成所需的文件,甚至可以将生成的结果以邮件、短信、平台消息通知的方式通知用户,让用户及时的进行分析与决策。

该章节我们将详细描述定时任务的设置方法及结果的查看。

在创建定时任务的时候,总共分为四步,这四步设置的所有信息也都保存在数据库中,在服务器调用的时候都会从数据库中已经创建的表中选择之前保存的设置信息。

2. 定时器(op=fs)编辑

FineReport 定时器功能作为一个独立的功能模块,可以在 FineReport 数据决策系统中对模板进行定时任务设置;

点击管理系统>定时调度,即可进入定时调度设置界面,如下图所示:

1572420023656872.png

2.1 任务管理

1)「任务管理」Tab 页下每个任务具有任务名称、使用模板(模板全路径)、上次运行时间、下次运行时间、运行状态 5 个属性;

在「任务管理」Tab 页下,可对定时调度任务进行管理,如下图所示:

1572420838834712.png

「任务管理」Tab 页下,每个任务末尾的按钮作用依次为:

  • 继续/暂停:继续/暂停任务。

  • 执行一次:点击运行一次按钮,该任务开始执行一次。

  • 编辑:编辑任务。

  • 复制:复制的新任务,主体内容与原任务一致,也可重新编辑。

  • 查看:可以快速概览任务情况。

  • 删除:删除任务。

2)「任务管理」Tab 页下,右上角的文本框支持搜索任务名称模板

下拉框内包括任务名称、使用模板、输出方式、上次运行时间和下次运行时间,如下图所示:

1572420511622487.png

2.2 运行监控

数据决策系统中,点击管理系统>定时调度,可查看「运行监控」Tab 页。如下图所示:

1572421789330044.png

注:「运行监控」Tab 页下的任务列表默认按照运行时刻倒序排列。

文本框支持搜索任务名称;

下拉框内包括任务名称、运行时刻、运行类型和状态,如下图所示:

1572421629598407.png

3. 定时器(独立 timer)编辑

如果不想通过决策系统来设置定时任务,也可以直接访问http://localhost:8075/webroot/decision/timer进入设置页面,如下图所示:

1572421950997700.png

详细设置过程请参照 timer 直接定时调度

4. 定时器设置编辑

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

点击定时调度页面上的全局设置按钮,即可看到运行失败提醒的设置,可勾选短信提醒、平台消息、邮件提醒,如下图所示:

1572422436103615.png

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

点击开启短信功能,详细设置请查看 短信,同时邮件提醒也需要配置发件人,详细设置请查看 邮箱 。

然后勾选「短信提醒」、「平台消息」、「邮件提醒」,再分别设置设置收件人,设置完成后点击保存,如下图所示:

1572422885502898.png

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

短信提醒:

222

平台消息:

1572424126243434.png

邮件提醒:

1572423687419507.png

5. 执行过程编辑

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

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

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

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

6. 设置步骤编辑

完整的定时任务分为如下几个部分:

基本设置>调度对象>调度周期>文件处理
详细点击 定时任务设置步骤 。

7. 注意事项编辑

问题描述:JAR 包为 2019-11-05 及之后的 FineReport 设计器,在其决策平台上创建「无调度对象」类型的任务后,如果再将 JAR 包回退到 2019-11-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



索引:

邮件正文预览报表内容图片显示

定时任务设置步骤

定时任务结果报表

timer 直接定时调度

表达式设定

定时任务之条件判断

定时任务发送邮件

定时任务发送短信通知

定时任务的权限控制

FTP 上传附件

自定义附件处理

定时任务简单示例之日报

定时任务之月报与年报

定时填报

定时调度中获取全局参数

定时器导出任务支持行式引擎插件