在Web报表中实现动态添加字段、 动态绑定查询或其它数据集

类别:.NET开发 点击:0 评论:0 推荐:


  目前开发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还没有完全公开通过编码来动态创建、修改报表模板的功能,
    所以,处理这种动态字段的要求还不是十分方便。希望感兴趣的朋友一起讨论。
   
    相关网址:http://www.soft2web.com/Webreport/index.htm

 

本文地址:http://com.8s8s.com/it/it45862.htm