自定义表单配置
===
表单支持：单表模型、一对多模型。
自定义表单是由JEECG智能开发平台开发的一组可视化表单设计功能，基于ueditor实现和bootstrap样式。 自定义表单模式有三种：预览、编辑和附加模式。 自定义表单可以实现以下功能：
*表单预览、动态报表显示(列表数据显示) ) ) ) ) ) )。
*支持表单数据填写、同时填写多个数据表、一对多数据填写、一个表批量填写多个数据等
#一、表单参数介绍
##1.自定义表单的参数说明
|表格|详细说明|
|-----|---|
|表单代码|自定义表单代码、唯一标识符和自定义表单的访问要求|
|表单名称|自定义表单名称|
|填写表格|该表格是否为填写表格|
|主数据源|选择要填写的主数据源，填写表单时必须|
##2.表单数据源参数说明
|数据源|参数说明|
|-----|---|
|数据源编码|查询数据集编码，同一表单下唯一|
|数据源名称|数据源名称|
|数据源类型|数据源如何检索数据集数据库表：数据集来自具有以下配置的数据库表名称；动态sql :数据集来自动态sql查询；Java类：计划实现|
|数据源|如果数据源类型为数据库表，则显示的连接的数据库、平台数据库为当前系统数据库和其他动态数据源配置|
|数据库表名称|当数据源类型为数据库表时显示的用于检索数据集的表|
|sql数据源|数据源类型为动态SQL时显示|
|填写数据源|数据源类型为动态sql时显示|
|填写数据库表|数据源类型为动态sql时显示|
##3.自定义表单设计图
！ 输入图像说明(https://static.oschina.net/uploads/img/201804/23195528 _ lup3. png '在此处输入图像标题')
#二、单表类型表单
##1.创建自定义表单
菜单：“在线开发”“自定义表单列表”“表单设计器”
接口如下图：
！ 输入图像说明(https://static.oschina.net/uploads/img/201804/23193822 _ 4g k2.png '在此处输入图像标题')
说明：
要创建自定义表单，请执行以下操作：
表单编码、表单名称、填写表单、保存表单
不首先选择主数据源。 此时没有添加表单数据源。 添加表单数据源，请参见2
##2.表单数据源
单击表单设计器左侧、表单数据源栏和加号以添加表单数据源
！ 输入图像说明(https://static.oschina.net/uploads/img/201804/23193930 _ 79hj.png '在此处输入图像标题')
！ 输入图像说明(https://static.oschina.net/uploads/img/201804/23194009 _ h93k.png '在此处输入图像标题')
！ 输入图像说明(https://static.oschina.net/uploads/img/201804/23194025 _ a1rw.png '在此处输入图像标题')
)1)数据源编码定义是唯一的
)2)根据数据源类型、情况使用不同场景。 本例使用动态SQL，
)3)填写动态数据源和数据源，一般选择平台数据源
)4)动态SQL :
``````
select * fromjform _ employee _ leavewhereid=' $ { id } '
可以输入“”作为参数。 其中abc是参数的名称。 例如：
选择* from table where id=$ { ABC }。
select * fromtablewhereid=' $ { ABC } ' (如果id字段为字符串类型)
``````
)5)记入数据库的表)选择的表名是显示的表，输入的数据是保存的表。 动态SQL查询中出现的字段与要填写在数据库中的表中的字段匹配，具有不同字段名的SQL使用AS别名匹配
(6)查询数据列)通过动态sql分析的查询列
(7)查询参数)分析动态sql中的查询参数
##3.设计表单内容
添加数据源后，可以设计表单的内容
)1)通过默认模板样式生成，默认模板样式由【在线开发-自定义表单模板】管理
)2)自己手动编辑表单
注：使用自定义表单控件：自定义表单控件
接口如下：
！ 输入图像说明(https://static.oschina.net/uploads/img/201804/23194234 _ gauc.png '在此处输入图像标题')
##4.测试自定义表单功能
【在线开发-自定义表单】
列表】中找到刚才添加的自定义表单
点击预览：
操作模式：有三种预览方式，查看模式，添加模式，编辑模式；
参数录入区：动态sql解析出来的参数
查看模式、编辑模式时，参数录入区要录入参数值；
添加模式不需要录入
####添加页面：
####查看页面：
####编辑页面：
添加、编辑成功后调整成功页面
## 三、一对多类型表单
### 1.创建一对多自定义表单
菜单：在线开发—自定义表单列表—表单设计器
界面如下图:
(1)自定义表单信息
设置表单编码，表单名称，填报表单；
主数据源暂时不填
点击左上角按钮，“表单保存”
(2)表单设计器左侧表单数据源，添加表单数据源
添加主表数据源，同1.2.2表单数据源，本例订单主表
添加子表数据源，同表单数据源，本例订单客户
### 2.设计表单内容
添加完数据源后可以设计表单内容
(1)通过默认模板样式生成，默认模板样式，在【在线开发—自定义表单模板】中管理
(2)自己手动编辑表单
注：自定义表单控件使用见：2 自定义表单控件
界面如下：
注：
(1)订单主表信息，从订单主表数据源获取，普通表单控件设置
(2)列表控件设置订单客户信息
列表控件配置如下图：
数据源：选择子表数据源，本例订单客户
外键字段：设置子表作为外键的字段
关联数据源字段：该字段配置自定义表单设置的主表数据源一起使用，该字段为子表外键与主表数据源关联的字段
定义规则 = {外键主表数据源编码.主表外键字段名字}
注：外键字段和关联数据源字段，如果在子表数据源中的动态sql中，有sql的关联关系的话，此处可以不填写，若没有体现，需要再此配置；
数据源类型为数据库表的情况下，外键字段和关联数据源字段需要填写
### 3.测试自定义表单功能
【在线开发—自定义表单列表】中找到刚才添加的自定义表单
点击预览：
操作模式：有三种预览方式，查看模式，添加模式，编辑模式；
参数录入区：动态sql解析出来的参数
查看模式、编辑模式时，参数录入区要录入参数值；
添加模式不需要录入
#### 添加页面：
#### 查看页面：
#### 编辑页面：
添加、编辑成功后调整成功页面
## 四、自定义表单访问请求地址
### 1.表单页面访问地址
自定义表单页面访问区分添加、编辑、查看，详细参考下面：
可以针对自定义表单不同的页面，做不同的权限控制；
|序号|操作|访问地址|
|---|--|-|--|
|1|添加页面|autoFormController/af/{自定义表单编码}/ goAddPage.do|
|2|查看页面|autoFormController/af/{自定义表单编码}/goViewPage.do?id={id}|
|3|修改页面|autoFormController/af/{自定义表单编码}/goEditPage.do?id={id}|