自定义表单配置

===

表单支持：单表模型、一对多模型。

自定义表单是JEECG智能开发平台开发的一套可视化的表单设计功能，基于ueditor实现，bootstrap样式风格。自定义表单模式有三种模式：预览、编辑、添加。自定义表单可实现以下功能：

* 表单预览，动态报表展示(列表数据展示)

* 表单数据填报，支持多数据表同时填报，一对多数据表填报，单表多条数据批量填报等

## 一、表单参数介绍

### 1.自定义表单参数说明

|表单|详细说明|

|-----|---|

|表单编码|自定定义表单编码，唯一标识，自定义表单访问需要|

|表单名|自定义表单名称|

|填报表单|该表单是否是填报表单|

|主数据源|选择填报的主数据源，表单填报时必须|

### 2.表单数据源参数说明

|数据源|参数说明|

|-----|---|

|数据源编码|查询的数据集编码，同一个表单下唯一|

|数据源名称|数据源名称|

|数据源类型|数据源获取数据集的方式；数据库表：数据集从下面配置的数据库表名获取,动态sql：数据集根据动态sql查询获取,Java类：待实现|

|数据源|数据源类型为数据库表时显示，连接的数据库，平台数据库为当前系统数据库，其他为动态数据源配置|

|数据库表名|数据源类型为数据库表时显示，获取数据集的表|

|SQL数据源|数据源类型为动态sql时显示|

|填报数据源|数据源类型为动态sql时显示|

|填报数据库表|数据源类型为动态sql时显示|

### 3.自定义表单设计图


## 二、单表类型表单

### 1 .创建自定义表单

菜单：在线开发—自定义表单列表—表单设计器

界面如下图:


说明：

创建自定义表单：

填写表单编码，表单名称，填报表单，表单保存

主数据源先不选择，这时还没有添加表单数据源，表单数据源添加见2

### 2.表单数据源

表单设计器左侧，表单数据源栏，点击加号，添加表单数据源




(1)数据源编码定义唯一

(2)数据源类型，根据情况使用不同的场景，本示例使用动态SQL，

(3)动态数据源，和填报数据源，一般选择平台数据源

(4)动态SQL：

```

select * from jform_employee_leave where id='${id}'

您可以键入’’作为一个参数，这里abc是参数的名称。例如：

select * from table where id = ${abc}。

select * from table where id = '${abc}'(如果id字段为字符串类型)

```

(5)填报数据库表：选择的表名，是展示的表单，录入的数据要保存的表，动态SQL查询出来的字段要和填报数据库表的字段保持一致，字段名称不一样的sql使用AS 别名使其一致

(6)查询数据列：通过动态sql解析出来的查询列

(7)查询参数：解析动态sql里面的查询参数

### 3.设计表单内容

添加完数据源后可以设计表单内容

(1)通过默认模板样式生成，默认模板样式，在【在线开发—自定义表单模板】中管理

(2)自己手动编辑表单

注：自定义表单控件使用见：自定义表单控件

界面如下：


### 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}|