水晶报表调用总结

前不久接到北方区一个个案, 比较有个性, 总结了一下大家以后碰到就有参考拉

 一.开发需求

规格如下:

程序编号 : CrystalReport.exe 程序名称 : 义利报表            画面:(备注:应用单选按钮)   页签一:销售报表 | 页签二:财务报表 | 页签三 ……(根据目录动态取)       销售额对比表      服务中心销售对比表      表3    ...... (根据报表文件动态取)     …….              …….                   …….     …….              …….                   …….     …….              …….                   …….                   查询                 取消   信息处理: 1.通过CrystalReport.ini文件去配置报表路径、服务器IP、数据库用户名、密码和数据库名称。 2.查询：根据单选按钮选择的报表，调用对应的水晶报表查询。 3.取消：退出查询界面。

 

二.解决过程

    1.沟通:

看了之后我比较茫然, 只知道要实现exe调用水晶报表, 说实话当时连水晶报表是啥东东长什么模样都不知道.后来与北方区规格撰写人曹铃铃多次电话沟通后才得知, 客户的需求是:

    该客户(义利)一直在使用水晶报表制作相关报表, 也许是水晶报表价格忒贵, 所以只有一个用户, 这样的话看报表的所有人都权限一样(最大权限), 都可以随意编辑保存报表, 并且要看一张报表还要打开水晶报表主程序, 比较麻烦. 因此产生一个问题, 报表文件的管理难, 做这个个案就是给浏览报表的人一个报表入口, 可以浏览报表而不能编辑.

    知道这个需求后, 我联系了易拓负责水晶报表的朋友, 了解到水晶报表其实是一个个的RPT后缀的报表文件, 报表逻辑全封装在里面, 要想脱离水晶报表环境预览它并不容易, 并且什么它的数据源连接方式也还不知道, 采用”推”模式还是”拉”模式也不知道, 具体相关的水晶报表元件是什么他也不了解……不过他告诉我用.NET开发兼容性会更好, 听的我一头雾水啊……

 

    2.知识储备:

    既然如此, 还是让曹铃铃把水晶报表安装程序发过来安装玩玩吧, 于是花了几个小时的时间从北方区传来安装程序并安装了, 并让她帮忙做一个简单的明细表给我, 方便我这边了解及测试. 看到水晶报表的真面目后发现它其实和SQL 2005的ReportService里的报表非常类似: 建一个报表前要建一个数据库连接并创建数据源并绑定当前报表, 然后往报表界面添加相关对象, 保存后是一个*.rpt文件. 哦, 于是上网搜索了一番总算有所得, delphi也是可以调用水晶报表的, 可惜找了很长时间都没有找到delphi5调用Crystal Repots XI的, 可能是delphi版本太老了, Crystal Repots XI又太新了, 郁闷拉. 不过一想, 这个个案和易飞没有关系, 和delphi也谈不上关系啊, 只要能调起Crystal Repots XI无论咋实现都行啊, 搜啊搜, 找到好多vs2005的调用方法, 不过太乱了, 毕竟Crystal Repots的版本太多了, 不同的版本调用方法也不尽一样, 下面整理了vs2005调用Crystal Repots XI的 J

 

水晶报表在应用时分两种方法，分别是拉模式（PULL）、推模式（PUSH）。拉模式：在水晶报表生成时的数据源是从水晶报表文件中的SQL语句从数据库中提取的，在编程时不用重写SQL语句，但要加上登录信息（具体方法，后面介绍）。推模式：在水晶报表生成时的数据源，是用编程时重写水晶报表中SQL语句而生成的dataset对像。也就是说，推模式是用dataset组装水晶报表。水晶报表组件介绍。水晶报表在VS2005中有两种组件，在WEB项目是分别是CrystalReportSource，CrystalReportViewer。在FORM项目里是分别是crystalReport，CrystalReportViewer。CrystalReportSource，crystalReport是水晶报表的数据提供者；CrystalReportViewer是水晶报表的浏览器。

不论是推模式还是拉模式都应使用ReportDocument和ReportViewer两个控件完成报表的数据加载和数据展现。

这样可以将表示层和基础业务逻辑分开, ReportDocument解决报表的封装，CrystalReportView解决报表的展现。

还有一种做法是使用CrystalReportViewer和CrystalReportSource控件, CrystalReportViewer的ReportSourceID属性指定数据的来源, CrystalReportSource控件指定rpt模板，如果模板中设置了过滤参数，可以用ControlID和界面中的数据选择控件关联，这种方法和sqldatasource很相似，但是这种使用方式会丧失灵活性，逻辑层次也不明确，和对sqldatasource一样，不推荐使用。

 

方式一：拉

在拉模式中如要在水晶报表中的SQL语句加上条件参数时要用{？参数名}方式给出。例：“SELECT T1, T2, T3 FROM T Where T1='{?parm}'” parm就是参数名, 以下例子中所用到的水晶报表文件中使用的SQL语句是“SELECT T1, T2, T3 FROM T Where T1='{?parm}'” parm就是参数名。

【1.WEB方式下】

using CrystalDecisions.Shared;
using CrystalDecisions.CrystalReports.Engine;
protected void Button_pull_Click(object sender, EventArgs e)

 

【2.FORM方式下】

 注意:在FORM方式下代码同WEB方式，但用crystalReport控件换掉了CrystalReportSource；用crystalReportViewer换掉了CrystalReportViewer；这两个控件都可以在工具箱里找到。同时在编程时去掉DataBind()方法。

private void Form1_Load(object sender, EventArgs e)

 方式二：推

在推模式中编程组装的Dataset里的SQL语句中的字段要与水晶报表里的SQL语句字段一致。简单的说，推模式中的水晶报表是个模板，把在设计器里报表的格式设好后，再组装DataSet就可以生成报表了。方法二里报表的数据来源已经不是报表模板使用拉模式获得了，是推模式的一种实现。这样实现的好处是这里的sql是由页面输入条件动态构造出的， 可以实现按条件的动态查询。不使用强类型dataset，用datatable非常方便。容易实现的优点从安全性上看就变成了缺点，页面输入拼装sql，安全性不高啊。如果涉及多个表，sql很长构造麻烦的情况，使用第二种可能不是很方便。

 

【1.WEB方式下】

using CrystalDecisions.Shared;
using CrystalDecisions.CrystalReports.Engine;
using System.Data.SqlClient;
protected void Button_push_Click(object sender, EventArgs e)

 

【2.FORM方式下】

  

private void Form1_Load(object sender, EventArgs e)

 3.开发

有了这些储备, 相信问题很快久能解决了吧. 于是针对个案需求选用vs2005下C#来做”拉”模式的”Form”下实现, 至于C#基本语法以及C#下怎样遍历目录, 遍历文件, 开启新窗体, 等等等 都可以在MSDN上查到相关资料来参考, 下面一同附上代码, 万一大家以后遇到可以参考: J

 

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using System.Collections;
using System.IO;
using System.Runtime.InteropServices;

namespace CrystalReport

 4.测试部署

编译后配置好ini后, 在我本地测试exe, 通过.

然而事情还没结束, 我们知道虽然它也是exe, 但是.net程序这个冬冬的运行环境和delphi可不一样, 它与java(须配置java虚拟机)类似, 也就是说要想在一台干净的电脑上运行.net程序还必须要安装.net的运行环境----dotnetframwork2.0, 所以我便在测试机器上安装了2.0环境, 本以为应该没问题了, 然而又让我 surprise了, 报了一堆错误, 肯定又是环境问题, 那该怎么搞, 在vs2005里找了一圈, 哦, 用vs2005自带的安装程序制作工具试试, 果然在做安装程序的时候vs2005检测到一堆”依赖项”, 并且这些依赖项都与Crystal Reports有关, 心里大悦啊, 这次总算可以了吧, 编辑后在测试机器上安装, 然后执行, 又报一个文件找不到的错误, 名字是 CrystalDecisions.Web.dll, 于是在回到安装程序制作里, 在应用程序文件夹里添加上这个文件, 再打包测试, 成功.:) (此安装程序发给曹铃铃测试ok)

虽然当前的问题解决了, 但是还遗留了一个问题, 就是上面说的测试通过的机器上有BO-BI的客户端环境, 或者有vs2005的开发环境, 或者有水晶报表的开发环境(仅仅XI版本), 另外我测试了一下, 在除.net外啥环境都没有的情况下会报一个错, 如下图: