1. 概述编辑
1.1 问题描述
除了 int 型简单自增主键,用户如何生成个性化主键呢?
例如 UUID32 位的主键,手动填写非常耗费精力。在进行填报时,使用者并不知道数据库中已经有哪些编号,此时如何保证编号唯一,不会覆盖已有数据呢?
1.2 解决思路
FineReport 设计器内置了 UUID() 函数,可通过填报字段的值绑定,继而产生唯一标识码,实现编号的唯一性。
2. 示例编辑
使用 UUID 来生成唯一编号有两种方法,填报属性中使用 UUID 公式和单元格中使用 UUID 公式。
2.1 填报属性中使用 UUID
2.1.1 新建数据集
新建数据集:书籍信息入库
SELECT * FROM book
where id is null
2.1.2 模板设计
1)设计模板主体页面,如下图所示:
2)添加填报控件,各控件属性如下:
2.1.3 添加报表填报属性
点击模板>报表填报属性,新增内置SQL
选择提交类型为插入提交,不显示原有数据
添加字段,并添加单元格。其中 id 字段为主键,值=UUID(32)
如下图所示:
注:该模板中,主键 id 无需出现在填报页面,因此 id 的值直接使用公式显示。
2.2 单元格中使用 UUID
或者可以在单元格中输入公式=UUID(32),在报表填报属性中将 ID 的值绑定为该单元格,如下图所示:
注:此时可以设置该单元格无控件属性,在填报状态下不可手动编辑。
2.3 修改行时不新增数据
上述方法使用了插入提交,新增信息的 ID 值不会重复
但用户如需修改某条信息,填报每提交成功一次 UUID 就会变化,保存多次的情况下,导致新增多条数据。
为了避免这种情况,可以修改填报属性,将 ID 的值设为公式=if(isnull(B11),UUID(32),B11)
注:if(isnull(B11),UUID(32),B11)表示当 B11 单元格中有值时,就修改该条数据;没有值时,就生成唯一的编号新增一条数据。
2.4 多个内置 SQL 中使用 UUID
如果该填报表是多源填报类型,比如员工基础信息存在表 1 中,员工部门信息存在表 2 中,表 1 与表 2 有相同的字段员工 ID,填报时这两张表都要保存员工 ID。
此时必须在单元格中使用 UUID() 生成员工编号,报表填报属性表 1 和表 2 的员工 ID字段绑定同一个单元格。
若使用上述方法 2.1 在报表填报属性中每张报表都使用 UUID() 函数,产生的序列号是不一样的,此时会导致员工 ID 不一致的情况。
3. 效果查看编辑
3.1 PC 端
保存模板,点击填报预览,填报如下信息,点击提交。
查看数据库,可以看到 32 位 id 正确生成,填写的内容也正确入库。如下图所示:
3.2 移动端
该功能支持移动端填报。
3.2.1 HTML5
3.2.2 App
4. 已完成模板编辑
已完成模板,可参考%FR_HOME%\webroot\WEB-INF\reportlets\doc\Form\填报报表之主键生成.cpt
点击下载模板:填报报表之主键生成.cpt