FineReport 报表工具使用总结

配置数据库连接

1. 点击菜单栏 【服务器】→【定义数据连接】，打开配置窗口：  2. 我们配置与项目工程中相同的数据库连接方式，这里是以oracle 数据库配置为例来说明： jdbc.property文件 ``` jdbc.driver=oracle.jdbc.driver.OracleDriver //数据库驱动 jdbc.url=jdbc\:oracle\:thin\:@127.0.0.1\:1521/mytest jdbc.username=aaa jdbc.password=111 ``` 要注意的一点是 在我们 web 项目中 是以 “**/**”+“**数据库名**”，而在 FineReport 中要改成“**：**”连接,例如上面代码中的 **jdbc.url**，我们配置的时候要改为 ``` jdbc:oracle:thin:@127.0.0.1:1521:mytest ```

工作薄中添加查询条件

有时，我们的表单需要顶部添加查询条件，例如我们要添加日期查询条件时

1. 首先要在我们的模板数据集中，查询语句中添加相应的查询参数

select count(distinct jc.GR_JBXX_ID) from MY_JC jc 
where  jc.jcrq between '${startDate}' and '${endDate}' 

2. 我们选中顶部眼睛图标，并选中参数面板处于可编辑状态，在右侧面板中添加相应的参数，startDate,endDate
   
3. 点击添加后参数面板会自动出现查询条件，我们可以选中其中一个控件，从右侧编辑相应属性。
   注意：当我们选择了日期控件后，控件名会和相同名称的参数值自动绑定
   

配置进入报表页面后自动查询

FineReport 设置参数面板后，默认不会自动查询，这时，我们先选中参数面板， 1.点击右侧属性中的控件名（默认为para） 2.在右上方控件【高级】菜单下，将 **‘点击查询前不显示报表内容’前面的√去掉；’** 保存后，重新预览时，页面将自动查询 

报表下钻功能实现

实现方式有两种： 1. 直接使用超链接：在单元格上直接添加点击的超链接，跳转相应页面； 2. 使用条件属性：当我们的下钻是有条件时，例如 我们下钻行政区划，到县一级就不能再点击时，我们就应该使用条件属性配置。 选中单元格，鼠标右键，在弹出菜单中点击【条件属性】，如下配置： 

点击【编辑】后，打开超链接编辑窗口，如下配置：

报表中隐藏参数

开发过程中，我们传递的参数不需要在页面直接显示，如何隐藏起来呢 ？ 方法就是**将需要隐藏的参数单独放在一行或一列中，设置隐藏参数所在的行高或列宽为0**；

报表中隐藏参数的查看

当我们需要查看隐藏参数时，必须同时选中隐藏参数行的**上一行和下一行**，右键弹出菜单中点击【取消隐藏】，即可显示隐藏的行。

自定义菜单–返回按钮
当我们实现下钻功能后，FineReport 默认菜单中没有返回按钮，这时，我们就需要自定义菜单了。具体步骤为：
1.顶部菜单中选择【模板】->【模板web属性】，打开 报表web属性窗口；
2.切换顶部标签到【分页预览设置】

3.当添加了自定义按钮后，会出现在左侧工具栏，我们点击自定义后的按钮图标，将弹出以下窗口，我们可以进行名称、图标、JS 事件绑定

4.自定义事件

报表部署在TOMCAT服务器

完成报表开发后，我们在工作中需要在服务器上独立部署，部署方法：

1. 解压tomcat服务包，并修改独立端口（默认配置为8080端口）；
2. 进入tomcat文件夹webapps下，将我们本地报表中的WebReport复制到webapps下
   注意：复制WebReport文件时，我们可以将WebReport\WEB-INF下的文件夹 frbak 删除（此文件夹是 FineReport 默认的自动备份文件）
   
   3.启动tomcat服务
   进入Tomcat服务bin目录下，点击运行startup.bat
   
   4.浏览器下访问报表

//修改localhost为服务器ip和端口，访问xxx.cpt,&后面为参数键和值
http://localhost:8080/WebReport/ReportServer?reportlet=xxx.cpt&xx=aaa