项目经验总结-Eclipse图表工具Birt的使用技巧(二)

作为Eclipse图表工具Birt的使用技巧(一)的后续,上一篇主要说明了Birt报表创建和使用的基本步骤和过程,本文旨在介绍一些常用的技巧,都是比较实用而且经过我本人实践可行的,希望能给需要的人带来一些帮助.

1. 报表参数传递

参数传递的应用场景比较广泛,在Birt设计器中有两个位置涉及到参数,一个是DataSet数据集创建的时候,有一个Parameters选项,另外就是在Data Explorer中有一个Report Parameters,这里主要介绍后者.因为Birt参数的对外接口就是Report Parameters,数据集中的参数也要通过这个报表参数去设置.

首先新建一个报表参数,如图:

这里创建一个默认名称的参数,其中Display type表示这个参数的显示类型,与它边上的hidden选项对应,如果hidden不打勾,说明这个参数会以Birt默认的View界面的形式表现.可以是多种形式,就是弹出一个窗口,要用户输入,这不符合项目的需要,所以通常我们将参数hidden.如下:

这时创建好了参数,说一点,这个参数的可作用范围是整张报表的rptdesign文件,在可以输入脚本和表达式的地方都可以通过params["NewParameter"].value使用.上面hidden复选框上面还有一个Is Requeired选项,如果勾选,意味必须要传递这个参数,否则报表会出错.

现在用这个参数,动态的改变一下数据集合,参数传递主要涉及几个问题,一个是URL传参,一个是同request传参,这是主要的两种传参方式,都会说明一下.

下面列出主要代码,分别书写在jsp页面(可以跳转到报表页)和数据集的脚本页.

jsp页面:

<a href="javascript:fun()">View Report (reports/demo_report1.rptdesign)</a>
<script>
var str = 
"<%=basePath%>"+"frameset?__report=reports/report1.rptdesign&__format=HTML&NewParameter='";
str = str + escape(encodeURI("二十五味地黄金刚大力丸")) + "'";
function fun(){
   window.location = str ;
}
</script>

DataSet Script页面:

importPackage(Packages.java.lang);

var sample = java.net.URLDecoder.decode(params["NewParameter"].value,"UTF-8"); 
System.out.println("-----------------------" + sample + "-----------------------");
if(sample == null){
   this.queryText +=" where ITEM_NAME= '治糜康栓'";
   System.out.println("-----------------------" + this.queryText + "-----------------------");
}
else {
   this.queryText +=" where ITEM_NAME=" + sample ;
}

上面就是URL地址栏传参的方式,在Script引入lang包是为了在控制台可以通过System.out进行输出,因为Birt内置脚本不支持alert等一些调试方法.它可以混合Java和Javascript脚本同时使用.

同时需要注意的是,URL传参会受到大小的限制,它和form表单的get提交时同一个道理.另外如果参数是中文需要进行特殊的函数处理,比较麻烦.

jsp页面:
<%
  request.getSession().setAttribute("NewParameter","二十五味鬼臼丸");
%>

DataSet Script页面:

importPackage(Packages.java.lang);
importPackage(Packages.javax.servlet.http);

var request = reportContext.getHttpServletRequest();

var sample = request.getSession().getAttribute("NewParameter"));

System.out.println("-----------------------" + sample + "-----------------------");
if(sample == null){
   this.queryText +=" where ITEM_NAME= '治糜康栓'";
   System.out.println("-----------------------" + this.queryText + "-----------------------");
}
else {
   this.queryText +=" where ITEM_NAME=" + sample ;
}

这里我是通过request的Session进行传递的参数,request也支持其他的方式.这种方式传参没有长度限制和中文转码的要求.