目前开发B/S结构下的Web报表工具比较多,但是某些比较复杂的功能仍然不尽如人意,本人也深受其苦。动态绑定数据集和动态添加字段的功能大家已经谈了很久,我也谈一下自己在Ming-WebReport工具下的实现思想,这里讲的方法应该不仅仅局限于Ming-WebReport工具,只是一个实现思想,其他工具,如Crystal Report等应该同样可以实现, 希望大家多交流。
最近公司购买了一个Web报表工具,叫Ming-WebReport,以下是本人使用Ming-WebReport的一点心得,跟大家交流分享一下。
Ming-WebReport 是如何解决 “动态添加字段” 和 “动态绑定结果集” 问题的:
1、Ming-WebReport 动态数据绑定的实现原理
Ming-WebReport报表工具有三部分:报表设计器、服务器端报表引擎和报表浏览器。
在报表模板中的动态数据有两种格式:独立的变量和格式公开的数据集。
<1>在报表模板中可以自定义变量参数,调用报表模板的页面可以动态为报表的变量赋值。
变量类型支持所有基本变量类型(包括数组);
报表和页面之间的参数传递就不多讲了,比较简单。
<2>设计报表模板的过程中,绑定的查询或者DataSet仅仅作为报表设计的样例数据,
样例数据的作用:
A.确定结果集和对应的字段名称;
B.确定结果集的数据结构(如多级子报表、交叉报表等);
C.调试报表模板
注:获取样例数据的手段有多种:
A.直接连结数据库(表/视图/SQL语句/存储过程);
B.导入标准格式的XML文档。
<3>报表设计完成之后被部署到服务器端, 需要调用服务器端的报表引擎,
动态绑定报表模板,为报表准备数据集。
A.Ming-WebReport报表引擎支持大部分流行的Web开发环境,
包括ASP、ASP.NET、J2EE和PHP。(这里以ASP.NET为例)
B.为报表绑定数据集的时候,提供给报表的数据集的字段要包含报表需要的数据字段, 字段名称一致就可以了。
a. 直接绑定结果集的脚本示例,此时DataSet包含报表需要的数据集字段:
//新建一个报表引擎对象
MREngine engine = MyViewer.Engine;
//设置报表目录的根路径(虚拟路径)
engine.RootPath = "/YourApp/Reports/";
/ /动态绑定dataSet,此处的数据集名称一定是设计报表期间设置的报表数据集名称。
engine.AddDataTable("ReportDataSetName", MyDataSet.Tables["table1"]);
engine.Bind("MyReport"); // 动态绑定报表
b. 手工构建报表数据集对象的脚本示例
因为Ming-WebReport的报表数据集对象的格式是公开的,所以可以手工创建报
表模板需要的数据集,这各功能是实现动态绑定结果集的关键。
//创建报表数据集对象
MRDataObject dataObj = new MRDataObject(this);
//1、创建数据集字段
//方法:MRDataObject.AddField(String "FieldName", Type FieldType,
// int FiledSize)
//创建一个字符型字段Filed1
dataObj.AddField("FieldName1", typeof(String), 20);
//创建一个整型字段Field2
dataObj.AddField("FieldName2", typeof(int);
//提示:上面的Type可以通过fieldValue.getType()来获得。
//2、以行为单位给数据集添加数据,
//每次添加一行,方法:MRDataObject.AddRow(Array RowData);
//参数是一个大小为字段个数的一维数组。
dataObj.AddRow(new Object[]{"StringValue1",1});
dataObj.AddRow(new Object[]{"StringValue2",2});
//也可以一次添加多行,方法:MRDataObject.AddRows(Array Rows);
//参数是包含多个行数据数组的数组。
Object[] rows=new Object[];
rows(0) = new Object[]{"StringValul3",3};
rows(1) = new Object[]{"StringValul4",4};
dataObj.AddRows(rows);
//3、为报表设置数据集,绑定报表。
//新建一个报表引擎对象
MREngine engine = MyViewer.Engine;
//设置报表目录的根路径(虚拟路径)
engine.RootPath = "/YourApp/Reports/";
//动态绑定MRDataObject
engine.AddDataTable("ReportDataSetName", dataObj);
// 动态绑定报表
engine.Bind("MyReport");
2、关于实现动态添加字段的方法
报表设计完成之后,模板格式基本上已经确定了,而动态添加字段的要求会影响到报表的布局格式, 但是Ming-WebReport目前并没有公开用脚本动态修改模板格式的API 不过可以借助变量参数来解决这个问题。
<1>首先考虑到报表模板的格式问题,需要控制动态添加字段的最大数量,这个最大数量根据报表
显示格式所能承受的数量为准。然后依照这个最大的字段数量来设计报表模板。
<2>然后是处理动态字段的数据的显示。
报表模板中需要动态控制的元素,如每个字段对应的Label,每个字段的值Value等,可以用数 据集来动态显示内容。报表中的数据元素可以分为单行数据集和多行数据集,这些都可以根据需 要定义不同的数据集。然后根据页面提供的数据集来动态的的显示数据。
提示:单行数据也可以用变量来传递数据。
<3>最后是动态字段的格式控制
控制动态字段的格式需要用到Ming-WebReport提供的模板脚本,但是它可以解决一些麻烦的问题。
控制动态字段需要定义专用的参数来标示要显示那些字段,要隐藏那些字段,然后我们就可以利用脚本,调用页面传递给报表的参数来决定显示那些字段,隐藏那些字段。
至此动态添加字段的功能就实现了,实际上是根据报表格式所能承受的最大字段量来设计报表,此时字段都是临时的,运行期间哪些字段显示,哪些字段隐藏是根据页面传进来参数,利用脚本来控制的。
3、总结
目前Ming-WebReport还没有完全公开通过编码来动态创建、修改报表模板的功能,
所以,处理这种动态字段的要求还不是十分方便。希望感兴趣的朋友一起讨论。