润乾报表V4技术资料

在润乾报表中，常常需要根据一些参数来动态改变报表的在web页面展现样式。润乾报表中对于单元格样式可以通过表达式来动态设置，大大降低了实现一些复杂功能的困难度。对于一些无法用表达式来控制的属性，运用润乾报表的API也可实现一些属性的控制。

在有一些报表中，表头是动态的，也就是说，表头列的个数不是一定的。本文介绍润乾报表中怎样实现web报表根据不同的情况固定不同的表头。

这里举一个动态设置左表头的例子（使用设计器自带的demo数据源）：

第一步：利用API生成一张新报表

package demo;

import java.io.FileOutputStream;
import java.io.OutputStream;

import com.runqian.report4.model.ReportDefine;
import com.runqian.report4.model.ReportDefine2;
import com.runqian.report4.usermodel.ByteMap;
import com.runqian.report4.usermodel.Context;
import com.runqian.report4.usermodel.DataSetMetaData;
import com.runqian.report4.usermodel.Engine;
import com.runqian.report4.usermodel.IByteMap;
import com.runqian.report4.usermodel.IColCell;
import com.runqian.report4.usermodel.INormalCell;
import com.runqian.report4.usermodel.IReport;
import com.runqian.report4.usermodel.SQLDataSetConfig;
import com.runqian.report4.util.ReportUtils;

public class apiReadReport {
public static void main(String[] args) {
//新建一张3行3列报表
ReportDefine rd = new ReportDefine2(3, 3);

rd.addCol((short) 2);
rd.addRow(2);
//设置展现字段
INormalCell inc1 = rd.getCell(1, (short) 1);
inc1.setValue(”类别ID”);

INormalCell inc2 = rd.getCell(1, (short) 2);
inc2.setValue(”类别名称”);
//设置表达式
INormalCell inc3 = rd.getCell(2, (short) 1);
IByteMap map1 = new ByteMap();
map1.put(INormalCell.VALUE, “ds1.select(类别ID,false)”);
inc3.setExpMap(map1);

INormalCell inc4 = rd.getCell(2, (short) 2);
IByteMap map2 = new ByteMap();
map2.put(INormalCell.VALUE, “ds1.类别名称”);
inc4.setExpMap(map2);

第二步：根据参数动态设置左表头

//设置几列为左表头(这个就是控制几列为左表头的参数,传进来几列,前几列就为左表头;参数为2,就是前两列为左表头)

int colnum = 2;//这个位置可以通过前台传递的参数来动态改变,例如:String colnum = request.getParameter( “colnum” );
//循环设置列的左表头属性,有把几列设为左表头就循环几次
for(int i = 0 ;i<colnum;i++){
IColCell colCell = rd.getColCell((short)(i+1));
//设置左表头
colCell.setColType(IColCell.TYPE_LEFT_HEADER);
}
//设置数据集
DataSetMetaData dsmd = new DataSetMetaData();
SQLDataSetConfig sdc = new SQLDataSetConfig();
sdc.setName(”ds1″);
sdc.setSQL(”SELECT 类别.类别ID,类别.类别名称 from 类别”);
dsmd.addDataSetConfig(sdc);
rd.setDataSetMetaData(dsmd);
try {
//保存报表
ReportUtils.write(”D:\\aa.raq”, rd);
System.out.println(”报表保存成功！”);//这个时候用报表设计打开报表,就可以看到前两列被设置成左表头了.
} catch (Exception e)
e.printStackTrace();
} catch (Throwable e) {
e.printStackTrace();
}
}
}

第三步:在展现报表的jsp标签中增加滚动条属性

<table align=center>
<tr><td>
<report:html name=”report1″ reportFileName=”<%=report%>”
funcBarLocation=””
needPageMark=”yes”
generateParamForm=”no”
needLinkStyle=”yes”
params=”<%=param.toString()%>”
needScroll=”yes”//是否固定住左表头
scrollWidth=”250″//固定表头报表的显示宽度
scrollHeight=”400″//固定表头报表的显示高度
exceptionPage=”/reportJsp/myError2.jsp”
/>
</td></tr>
</table>

效果：设置后的报表模版：

参数模版：

参数模版中B2单元格的web变量设置：

这样就可以通过参数模版来设置表头的个数了。

在页面上的展现效果为：

当报表中的一些功能无法通过单纯设置报表模版来实现时，利用API也可以达到想要的效果，而且，利用API还可以完成一些较复杂的功能，如一些动态变更展现效果，动态更换数据源等等。