填报设置

1.概述

1.1 支持版本
报表设计器版本
since 5.7
1.2 功能介绍

填报设置是作用是报表数据和数据库之间的映射。填报设置功能如下:

  • 报表数据取值来源,包括单元格、函数

  • 报表数据如何映射到数据库,每条数据对应具体的数据库字段

  • 包含多个填报设置,实现多源填报

2.填报设置详解

2.1 功能介绍

依次点击菜单栏「设置」,「填报设置」,弹出填报设置窗口,如果下图所示:

报表填报设置入口

点击左侧「+」,新建填报设置。右侧窗口为具体填报设置,选择数据库和数据库表后,点击「+添加字段」,新建单元格和数据库表中字段映射。

注意:填报设置作用域是当前Sheet,其他Sheet需要设置填报,则需要先切换到该Sheet,在添加填报设置。

2.2 多个填报设置

多个填报设置,则具有多个报表数据和数据库之间的映射,在提交数据时,会将报表数据分别插入到多个数据库中。

2.3 主键

在设置填报字段映射时,第一列是主键选择项,可以设置多个主键。注意,该主键不同于数据库概念中的主键, 数据库中主键指的是一个列或多列的组合,其值能唯一地标识表中的每一行,通过它可强制表的实体完整性。填报设置中主键作用是, 当报表数据中一行数据插入数据库中时,首先检查主键是否存在,如果存在则做更新操作,否则插入操作。 如下图所示,首先会查询id和name是否存在,如果存在,则更新,否则插入。

报表填报主键
2.4 值类型

字段映射中值类型,可以是单元格或者表达式。 单元格,顾名思义,直接取单元格数据,值输入单元格即可。表达式,则值为表达式执行得到的值,注意表达式必须以「=」开头,下面列举出常用的表达式:

  • uuid(),返回唯一标识码,常用语生成主键

  • 报表数据如何映射到数据库,每条数据对应具体的数据库字段

  • now(),返回当前日期,格式为:yyyy-MM-dd HH:mm:ss,常用于更细日期、创建日期等场景