历史版本11 :智能添加单元格组 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 应用场景

如果填报报表中直接拖入数据集字段,通过单元格扩展的方式展示原始数据

Snag_3833ef95.png

或者不显示原始数据,直接空数据填报时

Snag_38388e33.png

因为前端填报时单元格可以扩展,所以使用智能添加单元格绑定一个单元格就行,如下图所示:

1596418295145523.png

如果设计填报表格时,并不是拖入数据集字段进行单元格扩展,而是预先定义字段下的几条记录,只更新这些记录的数据,如下图中的科目代码科目名称字段对应的几条记录:Snag_383f2ecb.png

此时需要使用智能添加单元格组,将每条记录对应的填报单元格固定死,只有这些单元格填报后的数据才能入库,未添加的单元格提交后也不会入库,如下图中只能填报前 4 条记录:

1596418547748422.png

1.2 操作方法

智能添加单元格组的方法如下图所示:

1596420594398917.gif




2. 实现思路编辑

报表填报属性中为某个字段绑定单元格组,如下图,数据表中的会计科目科目代码字段在一个内置 SQL 中分别绑定了一个单元格组,那么在执行填报功能的时候,FineReport 后台会自动将单元格组根据位置拆分为多条内置 SQL。
222

如上填报属性绑定单元格示例,在执行填报过程的时候,就会拆分为以下 4 个内置 SQL 分别执行:

[uuid(),A2,B2]、[uuid(),A3,B3]、[uuid,A4,B4]、[uuid(),A5,B5]

注:拆分内置 SQL 时是根据位置拆分,并且当单元格和单元格组并存的时候,单元格的值重复根据单元格组内单元格个数进行复制。

和分别定义 4 个内置 SQL 一致,4 个 UUID 的结果是不一样的,并且其中一个失败,其他两个都会回滚,保持事务的一致性

注:绑定单元格组是先拆分为多个内置 SQL 入库规则,然后再形成 SQL 语句提交入库,而不是直接形成 SQL,因为单元格的值可能也是数组。

3. 示例编辑

以描述中的模板样式为例,我们在 Web 端录入几个会计科目的期初余额和期末余额,然后通过单个内置 SQL 将数据填报入库。

3.1 模板样式设计

按照上图所示样式设计报表,期初余额和期末余额控件类型均设置为文本控件。

3.2 报表填报属性设置

点击模板>报表填报属性,点击添加按钮,添加一个内置 SQL,为数据字段绑定单元格组,如下图:
222

注:单元格组手动编辑的时候,单元格间的分隔符支持英文的逗号、分号和空格。

另:如果单元格组内单元格个数超过 5 个,将不再显示所有单元格,而是直接显示“已经选择 X 个单元格”,如下图:222

注:绑定多个单元格时,不能使用公式,因为单元格数组是先拆分为多个内置 SQL,然后再形成入库sql语句,而公式数组则是直接形成入库 SQL 语句,不会拆分为内置 SQL。

3.3 校验

如果列的值设置为单元格组,则需要保证设置的各单元格组个数相等,这样才能够一一匹配起来,不允许如一个列是 3 个单元格,一个列是 4 个单元格,在智能添加单元格组对话框时点击确定或者在填报属性界面修改之后点击确定会弹出警告框,如下图:
222

3.4 效果查看

点击填报预览,在前面 4 个科目输入对应的期初余额和期末余额,如下图:
222

注:由于在设置填报属性的时候,单元格数组只绑定了前面 4 行的数据,故我们这里只对前面 4 行操作

点击提交按钮,将数据入库,点开日志面板,可以看到如下图所示日志信息,从日志中我们可以看出内置sql绑定的单元格数组的确是被拆分为多个内置 SQL 之后,在形成 SQL 语句执行提交操作:
222

然后再新建通过数据集查看科目余额表数据表中的数据,如下图,可以看到更改的 4 个科目数据发生了变化:

模板效果在线查看请点击 CellsArrayForm.cpt


具体的模板设置可参考:%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Form\TypicalApp\CellsArrayForm.cpt