1. 概述
1.1 学习视频
本文学习视频:设置填报属性
1.2 功能简介
报表填报属性包括:提交设置、数据校验设置、填报快捷键设置,编辑界面如下图所示:
3 个功能设置项介绍如下:
提交:将填报数据的单元格与数据库表字段进行绑定,确保填报的数据可以录入到对应的数据库表字段下。
数据校验:提交数据时根据定义的规则对数据进行全局校验。前端填报点击数据校验或提交时,如果有不满足校验规则的数据,则弹出报错信息,且提交终止。
填报快捷键设置:设置填报预览时,控制光标移动的快捷键。
2. 提交
提交有 2 种方式:「内置SQL」和「自定义提交」,2 种提交方式的区别如下:
2.1 内置 SQL
内置 SQL 提交:将填报页面数据跟数据库表的字段绑定,在点击提交后按照设置将数据入库。其底层逻辑为使用 JDBC 方式执行常规的增删改 SQL 语句,示例如下:
插入:INSERT INTO table_name (列1, 列2,...) VALUES (值1, 值2,....)
更新:UPDATE 表名称 SET 列名称 = 新值 WHERE 列名称 = 某值
删除:DELETE FROM 表名称 WHERE 列名称 = 值
注:目前只适配了支持上述 SQL 语句的数据库,如果提交的数据库无法使用上述语句进行增删改操作(例如分区表),则普通填报无法支持。
设置界面如下图所示:
2.2 自定义提交
自定义提交:点击提交时,获取到填报页面的数据进行自定义的处理,比如上传到某个接口。需要通过编写java实现。
3. 数据校验
数据校验有 2 种方式:「内置校验」和「自定义校验」,2 种校验方式的区别如下:
3.1 内置校验
内置校验:用户可通过自定义的校验公式来对页面数据进行校验,也可以自定义校验出错时的提示语。
3.2 自定义校验
自定义校验:一些特殊的业务逻辑用公式校验实现起来比较复杂,希望可以交付给用户自定义的程序来判断,然后将结果返回给 FineReport进行提示。需要通过编写java实现。
4. 填报快捷键设置
点击中间的按钮可以交换光标移到下一列和下一行的快捷键,同时默认的移到上一列和上一行的快捷键也会随之改变。
光标移动效果如下图所示: