手把手带你了解帆软填报报表避坑指南

最近从没有接触过Finereport（以下简称帆软）的我收到了老板安排的新任务：用Finereport制作各区域现阶段KPI填报报表，填报完成后需要在前台页面中展示所有区域的KPI，本填报报表的目的是可以让老板快速了解各区域的KPI和相应完成情况。老板希望各区域名称按行展示，各KPI按列展示，并可以灵活删减，同时具备搜索功能，以及展示KPI编辑人的功能也必不可少。

对于从未接触过帆软报表的我，这个需求听起来不难，但是在制作过程中由于我熟练度欠缺，遇到了各种坑，下面我将分享避坑指南。

帆软默认数据设置为分组，但是，对于我们设置横向扩展的填报报表是不可以的，所以要把数据设置为列表，如果有很多行，怕麻烦，最起码也要把横向扩展的主键设置成列表，让它“带动”着其他行一起扩展。修改好后，原来表格中的.G就会变成.S(见图二)，接下来。要在单元格属性中把KPI列的扩展方向设置为横向。

图二

接下来，可以为需要填报的内容设置控件，例如设置下拉框控件，有是，否，部分，待定四个选项，用来反映某城市或省份是否有这个KPI, 仅部分网点有这个KPI，不清楚是否有这个KPI这些情况。并通过数据字典记录，具体操作请参考图三。

图三

如果在数据报表中已经有了相关选项的收录，可以直接使用数据报表和数据查询得到选项。设计好填报表格，添加填报控件之后，需要将填报数据的单元格与数据库表字段进行绑定，确保填报的数据可以录入到对应的数据库表字段下。

设计器菜单栏点击模板>报表填报属性，设置界面默认选择提交，点击+，选择内置SQL即可。选择提交类型即选择数据入库的方式，共有 4 种方式可供选择，我一般选择智能提交，然后选择数据库和表是为了获取数据库表字段，用于后面绑定填报单元格。随后添加字段，有 2 种方式：智能添加字段和添加字段。

• 智能添加字段：当需要添加的字段较多时，可以使用这种批量操作的方式，点击按钮后，默认选中表中全部字段，将不需要绑定的字段去掉勾选即可。
  

• 添加字段：当需要添加的字段很少时，可以用这种手动一个一个添加的方式。

点击智能添加单元格，将填报单元格跟数据库表字段进行绑定，操作方式为手动选取填报单元格，同时还需要设置主键。主键用于确认需要根据哪个或者哪几个字段来进行更新和删除操作，相当于 SQL 中 where 的效果，和数据库的主键不是一个概念。如果涉及到修改或删除需求，那么必须勾选一个或多个主键。

图四

查询语句代码如下：

SELECT * FROM `fine_test`where 1=1${IF(LEN(KPI) = 0,""," AND [KPI] IN ('"+KPI+"')")}

标黄部分需要根据自己的实际情况更换表名和字段名。

做好这一步之后，下一步在数据字典中添加需要筛选的列，简单来说就是distinct要筛选的列，并存入数据字典中，同时设置分隔符，操作步骤如图五所示：

图五

总结来说就是新建数据集用于存放筛选列的值，然后在数据字典中选择刚刚新建的数据集。设置数据字典这一步很重要，如果不设置的话，会出来筛选列表为空的现象。

友情提示：点击控件才能出现控件设置的相应内容。

至此，筛选功能已设置完成，下一步是添加/删除列设置，对于第一次接触的我是有一定难度的。

JavaScript代码如下

var arr = ['sc'];//定义需要执行事件的删除行按钮名称数组，如有多组则写法为['sc1','sc2']for (i = 0; i < arr.length; i++) {        var kj = $('[widgetname="' + arr[i].toUpperCase() + '"]:visible');         //获取页面上可见的删除行按钮元素         var sc = _g().getWidgetsByName(arr[i].toUpperCase());          //根据名字获取删除行按钮          for (j = 0; j < sc.length; j++) {                 kj.length <= 1 ? sc[j].setEnable(false) : sc[j].setEnable(true);                  //当控件只剩1个时，禁用控件，否则遍历启用所有控件       }}

在多人同时填报一个模板的时候，可能会出现后填报的内容覆盖掉先填报的内容的问题。会出现覆盖问题的原因，是因为主键没有根据用户区分，所以不同人提交的时候，可能出现主键一致的现象。根据提交逻辑，主键一致会执行更新操作，这就造成了上述问题。解决方案就是增加一个可以区分用户的主键，这就是我在最开始设置时会把编辑人也设置成主键的原因。

具体做法是将填报人字段的值设置为公式：$fine_username，这样提交时会将填报者的用户名填写到数据库填报人这个字段中去。

注：$fine_username需要登录后才能正常获取当前的用户名。

图八

注1：冻结必须从首行或者首列开始设置，不支持从中间设置冻结，不支持单独冻结尾行和尾列。

注2：当冻结的行包括可扩展的动态数据时，扩展出来的数据全部冻结。

注3：冻结的行列有合并单元格时，需要冻结合并单元格的全部行列。