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

1. 概述

1.1 版本

1.2 应用场景

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

2. 控件分类

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

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

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

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 执行速度较慢的情况下，设置默认值会对模板整体加载速度有明显影响。

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