AgileEAS.NET平台开发实例-药店系统-报表开发(下)

开篇

我们上篇讲述了如何基于平台的报表管理组件来进行报表的管理，我们并没有说明如何在项目中如何调用，我们设计好的报表。下面我们就来看看，我们如何来使用我们

设计好的报表，一种是直接使用平台原生支持的报表服务，还有一种是我们单独设计实现的报表服务，也就是所谓的脱离现有平台的限制，我们单独使用报表设计器来完成报

表开发工作。并且能够结合其他的平台来进行开发。本章我们就来就这些问题来详细的阐述。

大纲

1、使用原生的报表服务。

2、脱离平台使用报表服务。

使用原生的报表服务

        首先、我们先来说明下什么是原生的报表服务,原生的意思是使用平台底层支持的报表管理服务，也可以理解成将报表定义信息保存在平台的底层表“eas.REPORTS”表中

的这样的存储形式。

        其次、接着上篇我们讲述的设计报表流程，我们来看下，我们如何使用原生的报表服务，来打印报表。

        1、我们在药品入库页面中添加打印事件：



         2、在打印事件中添加如下代码。



         3、我们来看看打印报表的相关方法：



         然后这些代码配置好后，我们来运行下看看效果。



         上面也是比较简介，当然还能进行分组，例如我们修改报表按药品类型分组：



         大家发现了吧，还是非常的简单的，我们使用起来开发起来也是非常的快捷。并且报表本身提供了导出的功能，支持多种文件格式的导出。下面我们就来看看，我们如何

开发我们不使用AgileEAS.NET平台底部支持的报表，我们单独使用报表的功能如何来做。

脱离平台使用报表

        我们现在要脱离AgileEAS.NET的平台来使用报表，我们如何来使用呢？我想我们可以使用如下的几种方式来实现报表功能的调用。下面我们一一道来，但是我们在使用报

表控件的时候，还是会有些不如意的限制，例如：我们新建一个对象报表的时候，我们的对象必须是AgileEAS.NET平台”特定“的对象才可以被报表设计器识别，这里的特定

如何理解呢？下面我们先来看看这个特例吧：

        1、找到“bin”或“ref”目录下的报表设计器应用程序：



        2、点击“新建”选择对象报表：



        3、创建一个新的“对象报表”后，选择数据源：



         4、选择报表的数据源实体对象所在的程序集：例如我们现在要开发药品的入库，那么我们可以选择药品入库实体对象所在的程序集：



         5、点击“打开”后，报表控件会自动读取该程序集下的所有实体类,前提是该实体类必须是AgileEAS.NET平台规定的实体类，这里怎么里理解呢？我们来看，必须是标

记如下内容：

         table特性中的表名可以为空，如果是自定义对象的话。

         6、这样报表设计器就能识别出该对象了。



         7、我们这里Dm_rin作为我们的设计目标即药品入库：



         8、关于报表后续的具体调整，请参考如下报表设计文档：

         AgileEAS报表设计器使用说明书.pdf

         9、开发完报表后，我们既然不使用AgileEAS.NET平台提供的报表组件支持，那么我们必须自己维护报表的定义文件，不像平台提供的将报表的定义文件保存到数据库

中，那么我们如何来维护报表定义文件呢，我这里给出解决方案如下：在解决方案内新建一个”RDL“文件夹，所有的报表定义文件夹放在该文件夹中。



        我们知道报表定义文件的实际存储是以XML格式来存取的就好办了，数据库里面的存储格式也已经清楚了，那么我们就知道了，我们只要从.rdl文件中读取相应的报表定

义信息后就可以了，那这个就应该来说很容易，我们只要写一个辅助类即可，专门负责读取指定路径的指定文件名即可。

        我们先来看看为什么说这样直接读取就可以了？



        根据报表的名称，读取数据库，来加载该报表的定义信息到报表对象中。

        我们来断点一下：



       点击文本可视化工具查看具体的内容：



       平台提供的读取报表定义的方法：



       下面我们就来看看我自己书写的读取rdl文件中的定义信息的辅助类。

       1、读取当前工程下的RDL文件夹路径。



       2、读取RDL文件夹中的指定名称的报表定义信息：



       3、如果存在指定的报表定义文件，读取该定义文件的具体报表定义信息，如果存在多个同名的报表定义文件，则只读取第一个符合条件的文件的信息。



       4、这样我们就完成了RDL文件的读取，下面我们来测试下即可知道是否可行：

       将上面的通过平台提供的底层组件来访问报表并实现打印的功能，我们通过自定义的报表定义读取Helper类完成报表的打印工作。



       5、下面我们来运行下上面的程序：



       这样我们就完成了报表的定义和使用，很简单和方便吧，我相信大家能够一学习就能进行二次开发，或者进行报表的开发，当然如果说我们的系统中不存在指定的表映射

对象时，我们这时候需要自定义一个实体对象，此时一定要添加相应的表映射标记与列映射标记，但是此时记得一定不要在表映射标记中写表名。例如：



       这样就完成了报表的开发和设计。