跳到主要内容

报表定时导出

设置报表定时导出 版本支持 version 1.9.1+ date 20241202

在日常数据统计工作中,定期生成和导出报表是一项常见需求。然而,随着需定期导出的报表数量逐渐增多,重复而繁琐的操作不仅浪费时间,还可能降低工作效率。

为了解决这一问题,积木报表在1.9.1版本中全新推出了定时导出功能。通过简单设置即可创建定时导出任务,系统会在指定时间自动生成并导出预设报表,无需人工干预,极大地减少了工作量。

此外,导出的结果支持自动发送邮件通知相关干系人,确保信息及时传递。同时,还可以将导出的文件上传到对象存储中,方便数据的集中管理与访问。此功能的上线,为日常数据统计与报表管理提供了更高效、更智能的解决方案。

一、前置条件

  • 【必须】需要在服务器配置好批量导出的python环境或准备好导出插件,配置方式参考:批量导出配置
  • 【必须】需要再配置文件中配置开启自动导出功能( v1.9.6+ )
jmreport:
automate:
export:
enable-auto-export: false
  • 【可选】同步网盘功能需要在配置文件配置文件上传信息(不支持local类型);配置方式参考:文件上传配置
  • 【可选】邮件通知功能需要在配置文件配置邮箱信息;配置方式可查阅附件一、邮箱配置

如果要使用插件导出,配置文件中需要配置:

# 导出任务使用插件
jmreport.automate.export.job-use-plugin=true

二、报表定时导出设置方法

1、进入定时导出模块

2、点击新增按钮

3、填写导出任务信息

字段解释:

  • 任务名称:未定时任务设置一个可以区分的名字。
  • 执行频率:CRON表达式。

  • 开始时间:只有当前时间大于开始时间时,导出任务才会生效。
  • 结束时间:只有当前时间小于结束时间时,导出任务才会生效。
  • 邮件通知:导出任务执行完成后是否发送邮件。

  • 收件人:填写接收通知的邮箱地址,多个用逗号分隔。
  • 同步网盘:导出任务成功后,是否将导出的结果同步到网盘中。

  • 同步目录:文件上传到网盘的基础目录。

4、添加需要导出的报表

点击导出报表后的新增按钮,打开新增报表弹窗。

在新增报表弹窗中,可以选择报表、设置报表的导出类型并且设置报表参数。

字段解释:

  • 选择报表:下拉选择积木报表中已设计的报表,支持搜索。

  • 导出类型:指定当前选择的报表的导出类型。
  • 参数设置:指定报表的参数。

三、启动、停止定时任务

1、启动定时任务

设置完成的任务可以通过操作栏中的启动按钮启动任务。

启动后,定时任务会在设定的时间自动开始导出报表。

2、停止定时任务

启动中的人物可以通过操作栏中的停止按钮停止任务。

四、查看任务执行结果

1、查看定时任务执行记录

点击操作栏中导出记录按钮,可以打开导出记录弹框,在该弹框中可以查看当前任务的所有导出记录:

导出成功的定时任务的操作列有下载按钮,点击该按钮会下载本次任务导出的报表。

2、邮件接收导出任务执行结果

导出完成后发送的邮件格式如下所示:

可以通过点击下载链接来下载已导出的按钮。 如果设置了同步网盘,网盘同步后的访问地址也会附在邮件中。

附件一、邮箱配置

jeecg:
jmreport:
# 邮件发送
mail:
# 是否开启
enabled: true
# 邮件服务器地址 eg. smtp.xxx.com
host: "???"
# 发件人名称
sender: "???"
# 发件人邮箱账号
username: "???@??.com"
# 发件人邮箱密码
password: "???"