自定义报表之自定义参数界面

文 | 帆软数据应用研究院 2014-12-26 17:45:23

自定义参数界面是自定义报表工具FineReport自定义性的表现之一。用户系统可能已经使用自己的框架,如.net、jquery、ext等中的控件实现了条件查询界面,不需要再使用FineReport内置的参数界面,此时如何将用户表单控件的值传递给报表呢? 在FineReport中,可以使用自定义的方式实现这种效果:用户自己实现条件表单界面,在点击如“查询”等按钮时,获取控件的值拼接出最终的报表url,赋给form表单的action,再触发表单提交事件。 若控件值为中文,表单提交前需要先使用cjkEncode进行编码。 我们以html网页为例简单说明,最终效果如下:

自定义参数效果

模板准备

打开模板%FR_HOME%WebReportWEB-INFreportletsdemoparameternumber.cpt 切换至参数界面,在左上角的设置按钮中,去掉显示参数窗体和点击查询前不显示报表内容两个选项前的勾,如下图:

模板准备

模板另存为%FR_HOME%WebReportWEB-INFreportletsdemoparameternumber1.cpt

自定义表单界面

实际系统中使用的框架不同,控件的种类和定义方法也不同,因此如上图中的表单查询界面我们不做介绍,用户自行实现,该例使用最简单的html元素。 主要注意的是form表单的action地址及表单提交结果显示位置target; 如该例中定义form表单时没有指定action,target的值为嵌入报表的iframe名字。 另外我们在点击查询按钮时需要先获取控件值,并且需要进行cjkEncode,因此查询按钮type使用button,不要使用submit(直接触发action)。

自定义表单界面

表单提交事件

点击“查询”按钮时,触发autoSubmit(),在该方法中通过js获取表单控件的值,拼接出完整的报表访问路径,并对最终的url进行cjkEncode编码。 将最终的报表url赋给form的action,并触发提交,返回的报表结果就会显示在指定的iframe中。

自定义表单提交事件

注:需要引入cjkEncode源码或finereport.js才能使用cjkEncode方法,详见Web传递中文参数文档。 示例完整代码 自定义参数完整外码1自定义参数完整外码2自定义参数完整外码3自定义参数完整外码4

已完成页面查看%FR_HOME%WebReport|page_demoparameter.html

免费试用FineReport

 

免费试用FineReport

阅读次数:527


返回顶部