数据图表软件-FineReport控件简介

1. 概述

1.1 版本

报表服务器版本	功能变更
11.0	--

1.2 应用场景

在帆软报表的具体应用中，经常使用「控件」来实现不同的功能。根据使用方式可将控件分为填报控件和参数控件两大类，填报时使用的控件为填报控件，参数界面使用的控件为参数控件，这两种控件的类型基本相同，只是在使用方面略微有所不同。本文整理控件相关文档，用户可根据本文快速查找所需控件文档。

2. 控件分类

控件类型详细统计如下表所示：

注1：参数面板中，所有控件以及插件类的「控件名称」均不支持为空或重复。

注2：控件的「属性」设置界面，所有输入框类型的位置都不支持写 HTML ，如 

控件类型	具体控件	控件简介
参数控件/填报控件	文本控件	昵称、名称等填写，用户按照规则要求输入即可
	文本域控件	文本域控件支持换行符，当用户需要输入或编辑长字符串时可使用该控件
	数字控件	可通过该控件输入数字信息（整数、负数、小数）
	密码控件	可通过该控件输入密码信息，录入密码
	按钮控件	可通过该控件执行提交、插入行、删除行、树节点展开与关闭等操作
	复选按钮控件	可通过该控件执行批量选中操作
	单选按钮组控件	当选项数量小于等于 4 时，一般使用单选按钮组控件
	复选按钮组控件	当选项数量大于 4 时，一般使用复选按钮组控件
	下拉框控件	通过该控件下拉选择某个选项信息，录入或查询数据
	下拉复选框控件	通过该控件下拉选择多个选项信息，录入或查询数据
	日期控件	当用户需要输入一个时间，使用日期控件，弹出时间面板进行选择
	下拉树控件	可通过该控件选择具有多层树状结构的数据，录入或查询数据
	视图树控件	可通过该控件选择具有多层树状结构的数据，录入或查询数据
填报控件	文件控件	可通过该控件上传文件
	列表控件	可通过该控件选择单条数据信息
	网页框控件	可通过该控件在报表页面中嵌入其他网页或报表
参数控件	标签控件	可通过标签控件给控件的「标签名称」进行赋值
	查询按钮	点击该按钮后查询数据
	预定义控件	一般应用于定义比较复杂且需要重复使用控件的地方

3. 控件与参数的绑定方式

1）在使用参数控件时，当已经完成全局参数、模板参数或数据集参数设置后，编辑参数面板，选择全部添加即可添加与参数绑定的参数控件，如下图所示：

2）编辑参数面板，选择需要的控件，设置参数控件的名称为对应的参数名也可以完成控件与参数绑定。例如：设置模板参数为货主地区，编辑参数面板，拖入下拉框控件，设置控件名称为货主地区。如下图所示：

3）填报控件与参数绑定示例。

4. 注意事项

4.1 浏览器推荐

推荐使用谷歌内核浏览器或者高版本的ie浏览器，比如Google Chrome、Microsoft Edge、IE11等。对于低版本IE浏览器，比如IE8和IE兼容模式，部分控件相关功能可能无法使用。

4.2 数据字典联动会清空控件值

当前功能设计下，控件在触发数据字典联动时，会清空被联动控件的值。

4.3 有控件值的参数面板控件在初始化时就会计算数据字典

带有数据字典设置的参数面板控件，如果没有默认值，则其数据字典会在点击控件触发选项时才会计算；如果有默认值，则在控件初始化的时候就会计算数据字典。所以当数据字典的 sql 执行速度较慢的情况下，设置默认值会对模板整体加载速度有明显影响。

4.4 文本和数字控件输入不符合校验规则的值后，会返回上一次输入的值

设置了校验规则的文本或者数字控件，当输入值不符合规则的时候，会有相应提示，并且当前输入值会被清空，返回上一次输入的值。

4.5 控件数据字典的数字丢失精度

问题描述

注：11.0.6 及之后的版本，控件的数据字典数字类型精度更加准确，不会再出现以下问题。

当控件数据字典使用的字段类型为数字类型时，例如 bigint，有可能会出现丢失精度的问题，如图所示：

解决方案

需要将数字类型转为字符串类型，例如下图所示在 sql 中进行转换。

总结

帆软FineReport带有数据字典设置的参数面板控件，如果没有默认值，则其数据字典会在点击控件触发选项时才会计算；如果有默认值，则在控件初始化的时候就会计算数据字典。所以当数据字典的 sql 执行速度较慢的情况下，设置默认值会对模板整体加载速度有明显影响。

在帆软数据图表软件使用过程中根据自己需求选择合适的报表设计模式，然后再新建数据集。然后进行帆软数据图表设计或者决策平台的搭建，进行报表设计的时候不仅要选择表格的样式，还要绑定数据、设置好参数等等。