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

目录:

1. 概述编辑

有关定时调度功能基本的介绍和操作方法可以参见文档:定时调度

定时调度任务设置时有四个操作步骤,如下图所示。本文将详细介绍这四个操作步骤中的设置项。

1578904847675543.png

注:在定时调度任务设置过程中,支持的公式请参考 定时调度支持的公式

2. 添加任务编辑

管理员进入数据决策系统,点击管理系统>定时调度>添加任务,如下图所示:

注:普通用户若需要设置定时调度任务,需要管理员 开启分级授权 后,为其分配「定时调度」管理节点的查看权限,具体步骤请参见 根据用户分配权限示例 

1578905108368674.png

3. 基本设置编辑

基本设置的设置项包括任务名称默认用户组,如下图所示:

1578905387183658.png

1)任务名称:

填写定时调度任务的名称,不能为空。

注:任务名称只允许包含字母、汉字、数字、下划线、减号、点和括号。

2)默认用户组:

设置默认用户组的目的是为了在「文件处理」时根据用户组成员发送通知,默认为无。

点击默认用户组的编辑按钮之后,可以根据用户、部门、角色来添加用户组成员。最终的用户组取用户、部门、角色的并集且去掉重复项,这三个都不是必填项,可以自由组合。

需要注意的是,用户的添加方式有两种:

  • 平台:用户来源于决策平台。

1.png

  • 自定义用户:用户来源于服务器数据集。

2.png

注:默认用户组可以为空,比如 FineReport 报表填报的时候不需要用户时,可以不设置默认用户组。

4. 调度对象编辑

调度对象步骤中对象类型分为三种,分别为:报表模板BI 模板无调度对象。下面将分别介绍。

4.1 报表模板

「报表模板」是安装路径 %FineBI_HOME%\webapps\webroot\WEB-INF\reportlets 文件夹下面的模板,为 FineReport 模板。

调度对象若选择报表模板,请参考 定时调度任务详细设置步骤 的 4.1 章节。

4.2 BI 模板

对象类型若选择为 BI 模板,如下图所示:

1578908056573777.png

1)对象类型

BI 模板:仪表板里创建的模板为 BI 模板。

2)选择模板

选择仪表板中的模板,不能为空。

3)过滤设置

支持对所选择的模板添加过滤条件,比如对所选择的销售管理中心驾驶舱添加过滤条件属于 2017 年的数据,如下图所示:

注:设置定时调度的账号需要有业务包的授权权限,才能在「过滤设置」对业务包内的字段进行过滤。

1573627810154325.png

4)调度结果

除通用结果外,会根据默认用户组内的用户单独生成结果;此调度结果按钮必须在「默认用户组」中选择用户才能选择。勾选该按钮后,可根据设置的 行列权限 给不同用户发送不同数据结果。

注:用户要有 BI 模板使用到的业务包权限才能勾选「调度结果」选项,否则预览模板时会失败。

5)文件名称

生成结果文件的名称,包括了结果模板、附件(excel、pdf),支持公式输入,比如${today()}

注:需勾选调度结果按钮才能使用公式,后面执行条件等输入公式同理。

6)附件存档

BI模板包含excelpdf可选。

7)文件处理

可配置文件处理的逻辑,默认选中不清理

若选择任务结束即清理,任务结束后会将 所有结果文件 都清理掉(包括 cpr 和附件),所以当所设置的定时调度任务需要使用定时调度附件时,例如在 文件处理 步骤中勾选「使用附件」的邮件通知,会出现结果文件被清理,无法找到的问题。

4.3 无调度对象

调度对象若选择无调度对象,请参考 定时调度任务详细设置步骤 的 4.2 章节。

5. 调度周期编辑

调度周期的设置项如下图所示:

1578908846242734.png

1)开始时间

配置结束立即执行:则开始时间为任务完成创建的时间。

设置开始时间:则开始时间为具体设置的时间。

1578908929379716.png

2)执行频率

  • 只执行一次:任务执行一次,此后不再执行

  • 简单重复执行:设置每隔n分钟/小时/天/周执行一次

1573628779773604.png

  • 明细频率设置:增加多种组合选择,添加明细频率,可以设置具体的执行时间/执行日/执行月,如下图所示:

1573628882942130.png

  • 表达式设置:表达式设定的文本框可自己手动填写 cronExpression ,也可通过点击旁边的查看预置表达式按钮来直接选择相应的表达式——点击查看预置表达式按钮时,展开预置表达式窗口,点击其中的文字说明,则其上的文本框显示并保存相应的 cronExpression,再次点击查看预置表达式按钮时收起预置表达式窗口,详细请查看 表达式设定

1573629138731912.png

3)结束时间

结束时间的选项根据上面的执行频率选择不同显示不同选项:

 结束时间

只执行一次

简单重复执行

明细频率设置

表达式设定

任务执行一次后即结束任务实际结束时间---
无限期-无结束时间,定时更新任务会一直定时执行无结束时间,定时更新任务会一直定时执行无结束时间,定时更新任务会一直定时执行
设定结束时间-根据设定的结束时间根据设定的结束时间根据设定的结束时间
 额外重复执行次数 -在设置的开始时间执行了定时任务之后会在间隔时间达到后再执行任务的次数  -

4)执行条件

执行条件是指在执行定时任务之前进行判断,满足条件才执行定时任务,不满足则不执行或者延迟一段时间后再校验执行。

1573629855162901.png

始终执行:不进行条件判断,直接执行定时任务。

5)任务重启

勾选如果任务中断按以下频率重新启动设置频率和次数。

1573629939554165.png

任务重启设定是一项防范措施,用于定时任务执行可能中断(例如网络原因导致邮件发送失败,不满足执行条件中断等)时的自动重启。如果定时任务执行中断且设定了自动重启,那么该定时任务就会按照自动重启项的设定重新执行直至成功或者达到所设定重启次数的最大值,任务重启设定默认不启用

定时任务执行重启遵循以下规则:
a. 如果快照生成失败,那么对应的附件发送不会执行;
b. 重启策略适用于条件判断、快照生成、附件发送三个方面的判断,逐一进行判断,如果不成功则进行确定是否采用了重启策略;
c. 重启时遵循任务最小化原则,即:如果快照生成正常、附件发送有问题,那么只需要重新发送附件,并且只需要重新发送之前发送失败的项目(邮件、FTP、自定义附件处理,哪个失败发送哪个即可)。
点击提交

6. 文件处理编辑

6.1 报表模板

「报表模板」的文件处理请参考 定时调度任务详细设置步骤 的 6.1 章节。

6.2 BI 模板

若选择 BI 模板,则为下图所示:

1573630311395467.png

默认勾选定时计算,其他处理方式手动勾选。

6.2.1 邮件通知

注:请先配置  邮箱

1573630448624168.png

1)收件人

默认只能使用「默认用户组」。

2)抄送和密送

支持用户选择和自定义邮箱,自定义邮箱可填入任意邮箱地址,包括系统外人员邮箱地址。

注:该自定义邮箱功能需 FineBI5.1 版本支持。

3)主题

邮件的主题。

4)文件描述

对于该发送邮件文件的描述。

注:使用附件,按照本地文件的设置,若本地文件中附件存档没有生成任何附件(包括 excel、pdf),则此选项灰化,不可选。

6.2.2 客户端通知

勾选APP通知,填写主题和内容,选择链接,如下图所示:

注:消息推送给 APP,必须把该仪表板挂到虚拟目录上,且推送的人必须是虚拟目录有权限看的人(超级管理员除外,此处指的是除去超级管理员之后的其他用户)。

1573630900208641.png

详细请参考 [通用]定时任务推送消息至APP

6.3 无调度对象

「无调度对象」的文件处理请参考 定时调度任务详细设置步骤 的 6.2 章节。

7. 注意事项编辑

7.1 附件乱码

问题描述:

Linux 系统中,定时任务「调度对象」中对象类型为 BI 模板,附件中的 PDF 文件中文乱码,图表组件和表格组件也出现中文乱码的情况。

原因分析:

系统没有安装中文字体。

解决方案:

系统安装对应字体后,定时调度导出的文件正常。

7.2 定时调度任务超时失败

问题描述:

定时调度任务执行时间超过 5 分钟,定时调度任务监控列表中显示失败,且报错:java.util.concurrent.TimeoutException

原因分析:

5 分钟的失败日志只是个超时提醒,任务实际还在执行。

解决方案:

任务执行正常,则不必理会该超时报错。

1)若不希望显示这个报错,可在fine_conf_entity表中修改ScheduleSettingConfig.taskTimeout字段值,根据任务的实际执行情况调高该超时阈值来延后超时提醒,该配置项单位为毫秒。

注:如果配了 Nginx 等转发,不可超过 Nginx 内配置的转发超时时间。

2)2020-01-15及之后的 JAR,若需要彻底取消该提示,可在fine_conf_entity表中修改ScheduleSettingConfig.timeoutRemind字段值为false,取消超时检查和提醒,但不影响任务本身的执行流程。

注1:修改 FineDB 数据库表字段值需要使用第三方管理软件连接 FineDB 数据库,在第三方管理软件中修改表字段值。

注2:使用第三方管理软件连接 FineDB 数据库的方法请参考 使用第三方管理软件连接工程内置 HSQL 数据库 FineDB