自定义报表开发说明

自定义报表开发说明

目录

1.自定义报表的目的 (3)

2.自定义报表的开发过程 (3)

3.自定义报表的技术原理 (4)

4.独立的报表设计方法 (6)

5.程序对独立报表的调用实现 (12)

6.报表的部署 (15)

7.报表的现场修改 (17)

1.自定义报表的目的

开发自定义报表的目的有以下几点：

1、实现报表和程序分离。分离的报表和程序的分离是实现自定义报表工作的最

主要目的。程序和报表分离可以使得报表的设计工作、程序的开发工作、报表的部署工作、报表的修改工作和报表的测试工作各自独立分开的来进行。

减少开发人员在报表上的工作量，实现报表设计的专业化分工。提高报表的开发效率和质量。

2、实现专业化的独立报表制作。报表设计工作的独立进行可以更好的实现报表

的专业化制作，原来每个报表的设计和制作都合并到了应用程序的开发过程中，由程序员各自来实现不同的报表。不同的程序员实现报表的方法不尽相同，研究新的报表类型要花不少时间，互相之间没有足够的时间来讨论总结各种报表的最佳实现方法。独立的专业化报表制作工作可以使得报表设计人员有大量的机会接触到不同类型的报表。随着报表制作经验的积累，可以有效总结出越来越多的不同类型报表的最优制作方法，形成有效的专业知识，提高公司开发报表的速度和可实现报表的广度。并且方便对报表进行独立测试，提高报表质量。

3、提高项目开发效率。报表和程序的独立，使得各自的工作方向更加专注。不

但使得项目开发工作能够并行，节省开发时间，而且使得各自的工作更容易深入，提高各自工作的攻关能力和工作质量。

4、方便部署。报表和程序分离后，各自部分能够独立更新。避免了更新报表也

产生新的软件版本的问题。在报表更新后软件部分没有变化的情况下，可以单独发布报表版本。实现了项目产品的灵活部署和配置。

5、灵活的报表定制。不同用户的报表格式不尽相同，相同的业务数据在不同的

用户那里会以不同的组织形式构成报表。而且用户的打印机型号更是多种多样。报表制作时使用的打印机型号和纸张可能是用户那里没有的，需要在用户那边进行报表样式的定制和打印效果的调试。以往这种调试只能由实施人员在现场反馈回开发团队，然后开发团队在看不到现场打印效果的情况下调整报表，不但交互次数多也不便与保证报表效果。

2.自定义报表的开发过程

自定义报表的开发过程遵循软件工程的过程：

1、需求调研需求人员从用户处获得报表需求，包括报表的尺寸、样式、显示

哪些数据、数据的类型、数据的格式、打印的份数和打印机的类型等等。需求人员提交报表需求时应详述报表细节，如有可能则提供纸质报表样式。2、报表设计设计人员根据需求人员提供的报表要求设计出报表的实际结构，

生成独立的报表文件。设计人员根据报表需求和完成的报表文件，进行报表的单元测试。设计人员需要模拟用户数据绑定到报表，查看打印预览并打印实际报表，将打印结果与提交的报表需求进行对比，确认报表文件可以满足用户需求。然后提交设计结果。

3、报表接口开发及调用程序员根据报表需求的数据结构要求开发获得报表

数据的代码。然后开发将封装的报表数据与指定报表文件绑定的方法。指定的报表文件名称可以从本地配置文件或数据库应用配置表中得到。程序员应

对完成的程序进行单元测试确保程序能够将数据绑定到报表，并且能够成功的调用报表预览和打印。

4、报表的测试测试人员根据报表需求和设计人员提交的报表文件，进行报

表测试。测试人员需要在应用软件环境中模拟用户数据绑定到实际报表，查看打印预览并打印实际报表，将打印结果与提交的报表需求进行对比，确认报表文件可以满足用户需求，记录测试通过，通知报表设计人员提交报表文件版本到配置管理。或者及时通知程序员或报表设计人员修改相关缺陷。5、报表部署配置管理员将最新提交的报表文件发布给实施人员。实施人员拿

到报表文件后在用户环境中进行测试。确认无误后将报表文件安装到用户的客户机或服务器。

3.自定义报表的技术原理

水晶报表程序控制上有两种模式，也就是PULL模式和PUSH模式。口语化点就是拉模式和推模式。

拉(PULL)模式：

由水晶报表模板（引擎）直接连接数据库(源)，从数据库(源)里拉取数据。就是我们在水晶报表里设置好数据库信息，以及相关的表。当我们在程序中调用水晶报表引擎，挂载模板后，水晶报表引擎会根据模板里的数据库信息，及表信息主动连接数据库，返回数据给报表模板，模板根据设计样式进行呈现。

基本流程如下图所示

推(PUSH)模式：

由应用程序从数据库(源)获取数据，然后把数据推送给水晶报表引擎。水晶报表本身不跟数据库进行交互。

其基本流程图如下

对比两个图，黑色的箭头表示我们要自己进行编码，蓝色的箭头表示是水晶报表与数据源的自动交互过程，不需编码。

这样我们很容易看到，使用PUSH模式将会比PULL模式多了不少代码。而且因为PULL模式是直连数据库，比PUSH模式的先获取数据结果，然后推送给水晶报表少了一个过程。而中间结果集本身就占用系统资源。所以PULL模式比PUSH 执行效率高。

那么两者的差异就出来了

1：PULL模式代码量少

2：PULL模式执行效率高

3：实际开发过的朋友也有体会，使用PULL模式，模板开发的速度也比PUSH 模式模板简单一些

这几点上，似乎PULL模式已经完全把PUSH模式打败了，那么为什么PUSH 模式还存在，且被大量使用呢？

我们再返回去看上面两个示意图，大家注意到PULL模式中，是由水晶报表连接的数据库，也就是说，水晶报表引擎单独占用了一个数据库连接。而只有在水晶报表对象释放后，数据库连接才会释放（这个时段对系统时间来说，是比较长的，特别是如果要翻页等需要长时间连接数据库的情况）。而在PUSH模式中，数据库是由应用程序去连接的，水晶报表本身不连接数据库。这样，系统就能使用公用的数据库连接。这样一来，就节约了数据库的连接消耗。这一点，在多用户的系统环境内，少一次数据库连接对系统性能的影响对系统的影响是比较关键的。当然，我们也应该注意到，PUSH因为存在一个Dataset，所以会占用系统资源。这两个方面大家需要综合考量。

这是个基本的，下面是PUSH的优势。

1：可以公用系统数据库连接，减少数据库连接损耗

2：可自由组合多数据源（如多数据库等），这一点PULL模式也可以实现，但是不如这个方便

3: 灵活多变

灵活多变的说法，是因为由于我们是把数据获取后，再PUSH给水晶报表的，那么在这个中间，就有很多数据再加工的可能性。

鉴于自定义报表在开发独立性和部署灵活性方面的要求，PUSH模式的报表开发是必然选择。

4.独立的报表设计方法

下面详细讲解一下PUSH模式下的报表的独立设计。

1、新建一个CrystalReports应用程序项目，（实际设计人员可以新建WinForm

项目和Web项目，没有区别）弹出下面这个界面后，输入“ExampaleCrystal ReportsProject”

然后点确定，会生成新的解决方案，并弹出报表制作向导选择窗口。

选择作为空白报表，点击确定。进入一个空白报表界面。

2、在解决方案资源管理器中的项目下新建一个数据集

在数据集设计界面上，点右键，添加一个datatable,命名为myTable。

然后在myTable里增加3个列。

注意要设置好类型。（ID:Int32;Name:String;Age:Int32）

特别说明：因为水晶报表里不认datatime型，对于2009-06-26 9:23:15会自动截断为2009-06-26所以datatime型数据在xsd文件中，可设置为string型而代码中的SQL中可把字段转换为String传入。

3、xsd设计完毕后，开始进入报表模板设计阶段。

进入刚才生成的空白报表界面，在字段资源管理器中的“数据库字段”上点右键，选“数据库专家”

在弹出的界面上，点“项目数据”，依次点开，找到我们刚才自己做的mytabl e加入到右侧选定的表中

确定后，在“数据库专家”下面会出现表名mytable，点开后会看到字段，把字段拖到模板上的详细资料节即完成基础模板的制作了

点一下预览，会看到虽然我们还没有任何实际的数据操作，但是界面上已经

有数据了，这是水晶报表的一个虚拟数据，可以看到一个最终显示的效果。

4、最后制作完成后点击保存项目。可在项目文件夹中找到项目最后生成的独立

报表文件。

5.程序对独立报表的调用实现

下面详细介绍一下程序对独立报表的调用以及如何绑定数据到报表。

1、创建一个新的WinForm应用程序项目,取名为CrytalReportInvoker.点击确定

2、在Form1中添加一个CrystalreportViewer

3、在Form1类中添加如下代码

public static ReportDocument ConfigureCrystalReports(string filename)

{

ReportDocument reportDocument;

reportDocument = new ReportDocument();

reportDocument.Load(filename);

return reportDocument;

}

ConfigureCrystalReports方法负责加载指定路径的报表文件，生成报表文档对象。

在From_Load事件中添加如下代码

private void Form1_Load(object sender, EventArgs e)

{

ReportDocument rt = ConfigureCrystalReports("crystalReport1.rpt");

//rt.SetDataSource(GetData());

rt.SetDataSource(GetDataTable());

crystalReportViewer1.ReportSource = rt;

}

在窗体加载时先从指定路径加载特定的报表文件名称，然后绑定数据源，数据源可以是DataTable，或者是实现了Ienumerable接口的集合类，比如Ilist<>等。有一点需要注意，不论是DataTable还是Ilist包含的对象都必须含有报表数据集结构中的ID、Name、Age三列或属性。

4、将独立设计生成的报表文件CrystalReport1.rpt复制到本项目的bin\debug目

录

5、执行应用程序，可以看到程序成功的加载了独立设计的报表。实现了报表和

程序的独立开发。

6.报表的部署

报表部署根据应用程序的类型不同分为C/S和B/S部署方式

1、C/S部署

在C/S模式下应用程序直接访问本地文件，可将独立的报表文件复制到应用程序所在的文件目录。

或者与开发人员进行约定将要访问的报表文件路径和报表文件名称设置成可配置的。然后将报表集中部署到指定路径中。再将配置信息放到应用程序的配置文件中。(由于不同的客户端硬盘分区不尽相同，安装路径也不一样。放到数据库中配置不能统一)

2、B/S部署

在B/S模式下应用程序通过浏览器访问服务器文件文件，可将独立的报表文件复制到应用程序所在的服务器文件目录。

或者与开发人员进行约定将要访问的报表文件路径和报表文件名称设置成可配置的。然后将报表集中部署到指定服务器文件路径中。再将配置信息放到应用程序的Webconfig配置文件中。(由于不同的客户端硬盘分区不尽相同，安装路径也不一样。放到数据库中配置不能统一)

7.报表的现场修改

修改报表的过程和设计报表的过程类似。之所以单独来说明主要是为产品实施人员在用户现场为特定用户进行定制修改提供显明帮助。这里所说的修改一般是指在用户现场进行报表修改以满足用户需要的方式。

1、现场文件更新

现场文件更新是指用户提出比较大的报表修改，包括数据结构、报表格式等等，现场实施人员将用户意见反馈回到开发部门。报表开发人员和程序员沟通共同完成程序和报表文件的更改。配置管理员将新的文件版本发送给实施人员。实施人员和部署方式一样将文件安装到指定的文件路径。完成修改过程。

2、现场报表修改

现场修改是实施人员在用户现场对报表的样式、纸张，打印方式等不影响数据结构的部分进行报表修改。（比如增加logo等）

这一部分的修改需要实施人员在现场具备报表开发环境，将独立的报表文件打开。对相关部分进行修改后保存。然后用新文件替换用户的报表文件。并进行现场测试。

3、现场制作

现场制作是指实施人员在用户现场在不更改程序数据集结构的前提下，为用户制作新的独立报表文件以满足用户的需求。这一部分的修改需要实施人员在现场具备报表开发环境，将原独立的报表文件打开另存成新文件。根据报表设计部分的制作说明生成新报表。然后用新文件替换用户的报表文件。并进行现场测试。