内置SQL提交

1.1 版本

1.2 学习视频

本文学习视频：设置填报属性

1.3 功能介绍

设计好填报表格，添加填报控件之后，如下图所示：

需要将填报数据的单元格与数据库表字段进行绑定，确保填报的数据可以录入到对应的数据库表字段下。

1.4 功能入口

设计器菜单栏点击模板>报表填报属性，设置界面默认选择提交，点击，选择内置SQL即可，如下图所示：

注：多个内置SQL的执行顺序为从上到下，串行执行。多个内置SQL属于同一个事务，如果其中一个 SQL 语句执行失败，整个事务都会回滚，即撤销事务中所有已经执行的 SQL 语句，确保数据库状态回到事务开始之前的状态。

内置 SQL 提交的设置步骤如下图所示，下面将对每个步骤做简单介绍。

2.1 选择提交类型

选择提交类型即选择数据入库的方式，共有 4 种方式可供选择，每种提交方式的逻辑和应用场景参见文档：提交类型

2.2 选择数据库和表

选择数据库和表是为了获取数据库表字段，用于后面绑定填报单元格，如下图所示：

注：部分数据库可能需要选择模式，例如oracle。

11.0.2 版本及之后，选择数据表时支持模糊搜索。筛选表的框中输入文本后，会根据输入的文本精确搜索相关数据库、模式下的表，将搜索的结果展示在下拉框中，供用户选择表。如下图所示：

2.3 添加字段

添加字段有 2 种方式：智能添加字段和添加字段，2 种方式的区别如下：

• 智能添加字段：当需要添加的字段较多时，可以使用这种批量操作的方式，点击按钮后，默认选中表中全部字段，将不需要绑定的字段去掉勾选即可。

• 添加字段：当需要添加的字段很少时，可以用这种手动一个一个添加的方式。

2.4 添加单元格

点击智能添加单元格，将填报单元格跟数据库表字段进行绑定，操作方式为手动选取填报单元格，如下图所示。

注：添加完单元格后，一定要再检查下有没有遗漏掉字段，字段跟单元格是否准确匹配上了。

2.5 设置主键

主键用于确认需要根据哪个或者哪几个字段来进行更新和删除操作，相当于 SQL 中 where 的效果，和数据库的主键不是一个概念。如果涉及到修改或删除需求，那么必须勾选一个或多个主键。如下图所示：

3.1 智能添加单元格组

当一个数据库表字段需要绑定多个单元格时，可以使用该功能，详细介绍参见文档：智能添加单元格组

3.2 批量修改单元格

该功能可以通过设置位置偏移批量修改单元格，偏移方式有 2 种，操作演示如下：

• 行偏移：偏移值为 n，单元格下移 n 行；偏移值为 -n，单元格上移 n 行。

• 列偏移：偏移值为 n，单元格右移 n 行；偏移值为 -n，单元格左移 n 行。

3.3 移除字段

可以删除已经设置的字段，操作如下图所示：

3.4 未修改不更新

勾选未修改不更新后，前端填报时，若记录没有被修改，则该记录不会参与提交过程。

在大数据量查询并回填情况下，启用该设置，可以明显提高填报的提交性能。

详细介绍请参见文档：填报未修改不更新

3.5 提交条件

提交条件可以用来对即将入库的数据进行过滤，满足条件的数据可以入库，不满足条件的不予入库，但并不会中断提交过程。

实际应用可参见文档：填报提交条件

3.6 提交事件

提交事件可以针对外层内置SQL影响的每条数据分别执行一次设置的提交事件操作，其执行动作会在外层的内置SQL结束后开始。