历史版本5 :填报控件 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
1. 概述编辑
1.1 应用场景
设计填报报表时，如果需要修改和新增数据，则必须要给录入数据的单元格添加填报控件。
FineReport 共有 16 种填报控件，分别适用于不同的填报场景。
1.2 功能入口
给单元格添加填报控件的方法：选中单元格，右边属性面板选择「控件设置」，点击「选择控件」下拉按钮，选择自己想要的控件即可。如下图所示：
2. 填报控件类型编辑
下表给出 16 种控件各自的使用场景简介，每种控件的详细介绍可点击对应超链查看。
| 类型 | 控件名称 &帮助文档 | 使用场景 |
|---|---|---|
| 填写 | 文本控件 | 填写单行文本信息，例如：姓名、邮件、手机号、邮编 ...... |
| 文本域控件 | 填写多行文本信息，例如：个人介绍、产品描述、问卷调研 ...... | |
| 数字控件 | 填写数字，例如：销量、利润额、成绩 ...... | |
| 密码控件 | 填写密码，且填写时密码隐藏不可见 | |
| 点击 | 按钮控件 | 点击后实现某种效果，例如：填报时插入行按钮、填报时删除行按钮 ...... |
| 选择 | 复选按钮控件 | 可以同时选中多条数据并对数据进行处理，例如：批量删除数据、提交多条数据、批量修改数据 ...... |
| 单选按钮组控件 | 有多个数据项可供选择，但是只能提交一个，例如：试卷单项选择题、问卷单选选择项 ...... | |
| 复选按钮组控件 | 有多个数据项可供选择，可以同时提交多个，例如：试卷多项选择题、问卷复选选择项 ...... | |
| 下拉框控件 | 点击下拉框显示多个选项，选择其中的一个填入单元格 | |
| 下拉复选框控件 | 点击下拉框显示多个选项，可以同时选择多个填入单元格 | |
| 日期控件 | 选择日期填入到单元格中 | |
| 文件控件 | 上传文件保存到数据库表中 | |
| 列表控件 | 选项以列表形式显示，选中其中一个进行提交 | |
| 网页框控件 | 单元格中插入其他网页或者报表 | |
| 下拉树控件 | 选择树状结构下的选项填入单元格，然后进行提交，支持单选或多选 | |
| 视图树控件 | 勾选树状结构下的选项，直接进行提交，支持单选或多选 |
3. 填报控件设置默认值编辑
填报时如果想要控件在一开始就有个默认值，只需要在设计填报模板时，直接在控件所在单元格里面填写即可。
例如：想要给下图模板的填写日期一个默认值，动态显示当天的日期。
只需要在设计模板时，在填报日期的单元格里写入公式=today()，如下图所示：
4. 注意事项编辑
4.1 数据字典联动会清空控件值
当前功能设计下，控件在触发数据字典联动时，会清空被联动控件的值。
4.2 有默认值的控件在初始化时就会计算数据字典
带有数据字典设置的控件，如果没有默认值，则其数据字典会在点击控件触发选项时才会计算；如果有默认值，则在控件初始化的时候就会计算数据字典。所以当数据字典的sql执行速度较慢的情况下，设置默认值会对模板整体加载速度有明显影响。
4.3 模糊查询会分开匹配输入字符
带有模糊查询功能的控件，比如下拉框，下拉复选框等，在匹配的时候会将多个字符拆开来进行匹配。例如输入ABC，则会匹配数据字典中同时有A、B、C且顺序一致的数据，而不是只匹配ABC连在一起的数据。
4.4 模糊查询会同时从实际值和显示值中进行匹配
带有模糊查询功能的控件，比如下拉框，下拉复选框等，如果数据字典设置了不同的实际值和显示值，在模糊搜索的时候，会根据输入字符，同时从实际值和显示值中匹配对应的数据。
4.5 控件校验当输入值不符合时，会返回上一次输入的值
设置了校验规则的控件，当输入值不符合规则的时候，会有相应提示，并且当前输入值会被清空，返回上一次输入的值。
4.6 填报控件未进入输入状态时，输入的第一个字会变成字母
在使用单元格控件进行输入时，需要双击控件进入输入状态后，方可编辑。如果只是选中了单元格，未进入输入状态，则输入的第一个字会变成字母。
