实现基于WebService上的CrystalReport与数据库连接

1. 引言

Crystal Report已内嵌为微软 Visual Studio .NET的标准报表工具，它的优点是：在 .NET 平台上能够轻松创建交互式的、高质量显现的报表内容；可以在 Web 平台和 Windows 平台上承载报表，并将 Crystal Report作为报表的 Web 服务在 Web 服务器上发布；利用Crystal Report 创建的Web应用程序，使用户可以深化图表并根据需要筛选信息。
本文简单介绍了在ASP.NET 中，如何利用WebService来实现Crystal Report与数据库的连接。
Web Service是基于通过网络支持计算机间的集成来设计的软件应用程序。它的接口用计算机可处理的格式（通常是WSDL）来描述。其他软件应用程序通过该接口描述的方式与Web 服务交流，利用SOAP 消息，通常是序列化的XML 通过 HTTP 或其它网络标准传输。
 
2. SQL Server准备工作

首先建立一个表，并创建一个存储过程和视图，存储过程将被WebService里的WebMethod调用，视图将方便数据集（.XSD）的创建。
2.1 与存储过程相比SQL语句方式有以下好处：
①　预编译，已优化，效率较高；
②　可以有效的防止SQL注入式攻击；
③　可以接受输入参数；
④　修改方便。
 
2.2 建立视图的好处是：

在创建数据集（XSD）时不用一个一个地加元素、指定数据类型，直接拖入已建好的视图即可。
 
3. 创建一个WebService项目

3.1调用EnterpriseLibrary

EnterpriseLibrary是可重用的程序块库，用于解决共性的企业级开发过程中所面临的挑战：
①　较低风险（经过实践验证的、精准的）
②　降低成本（可充用）
③　快速实施的问题（易用）
④　扩展性
⑤　一致性
正是因为它强调了一致性、扩展性、易用性和集成性问题，减少了代码的输入，并且可免费下载。因此我们选用了EnterpriseLibrary。
        在references里引用下面的几个EnterpriseLibrary，后面创建WebService时将直接使用它：
Microsoft.Practices.EnterpriseLibrary.Data;
Microsoft.Practices.EnterpriseLibrary.Configuration;
 
3.2 配置Config

Config有以下优点：
①　 ASP.NET允许配置内容可以和静态内容、动态页面和商业对象放置在同一应用的目录结构下。当管理人员需要安装新的ASP.NET应用时，只需要将应用目录拷贝到新的机器上即可。  
②　   ASP.NET的配置内容以纯文本方式保存，可以以任意标准的文本编辑器、XML解析器和脚本语言解释、修改配置内容。  
③　   ASP.NET 提供了扩展配置内容的架构，以支持第三方开发者配置自己的内容。  
④　 ASP.NET配置文件的更新被系统自动监控，无须管理人员手工干预。               因此将与数据库连接的相关信息写在Configuration里面，有明显的优势：易于部署；易于以编程方式访问；支持动态更新。  
 
 3.3 建立WebService

Web Servcie最主要的优点是，使用不同程序和在不同系统平台上开发出来的程序，都可以相互通信。另外它还可以跨防火墙地通信，集成了应用程序，集成了B2B，可重用软件和数据等等。下面是WebService 主要代码：
PersonMain.asmx：
....................
[WebMethod]
public DataSet PersonMain(DateTime birthday_from,DateTime birthday_to)
{  
// Create the Database object, using the default database service.
// The default database service is determined through configuration.
Database db = DatabaseFactory.CreateDatabase();
string Command = "Person_Procedure";   
//The Person_Procedure is the name of procedure.
DBCommandWrapper dbCommandWrapper = db.GetStoredProcCommandWrapper(Command);
dbCommandWrapper.AddInParameter("birthday_from",DbType.DateTime,birthday_from);
dbCommandWrapper.AddInParameter("birthday_to",DbType.DateTime,birthday_to);
//Bothe @birthday_from and @birthday_to are the parameter of procedure.   
DataSet ds = null;             
ds= db.ExecuteDataSet(dbCommandWrapper);
// Note: connection was closed by ExecuteDataSet method call
//return productsDataSet;      
return ds;
}
....................
 
    在实际工作中，为了在调用时能一目了然地知道它的功能，通常将[WebMethod]加上简单的描述语句，格式如：[ WebMethod ( Description = "Your description information about this WebMethod" ) ]
 
4. 创建一个WebApplication项目

4.1引用

①　首先在references里加上下面的几个CrystalReport相关的引用，因为后面的CrystalReport要用到它们：
CrystalDecisions.CrystalReports.Engine;
CrystalDecisions.Shared;
CrystalDecisions.ReportSource;
②　在Web References里加上刚才在WebService里创建的PersonMain.asmx，并取名为PersonMain。
 
4.2 数据集(.xsd)和CrystalReport(.rpt)

①　Web   Service平台是用XSD来作为数据类型系统的。当我们用某种语言如VB.NET或C#来构造一个Web   Service时，为了符合Web  Service标准，所有我们使用的数据类型都必须被转换为XSD类型。
新建一个数据集PersonDS.xsd，从服务器资源管理器中把我们已做好的视图拖进来。
 
②　新建一个CrystalReport：Person.rpt。把刚才新建的数据集PersonDS.xsd加进来，将字段拖入报表中相应的位置。如果有多个视图，要通过相关字段将它们连接起来,同时要保证有且仅有一个出发点，最终不能有孤立点,而且不能有回路。
 
4.3 数据加载

①　在WebApplication项目里加一个类，它的作用是把数据集加到报表中去，下面的数据加载类将调用它。在实际工作中，我们通常将它和其它一些通用的方法放在一起做成.dll，方便调用。下面是这个类的主要代码：
DBTable.cs：
....................
public void addTableforReportDataSet(DataSet srcds,string dtname,DataSet rpds)
{
 if(srcds != null)
 {
 if(srcds.Tables.Count > 0)
 {
   if(srcds.Tables[0].Rows.Count > 0)
   {
    foreach(DataRow copyRow in srcds.Tables[0].Rows)
{              
rpds.Tables[dtname].ImportRow(copyRow);
     }
    }
   }
 }    
 }
....................
②　新建一个数据加载类，主要代码如下：
PersonLoadData.cs：
....................
public ReportDocument generateReport(DateTime birthday_from,DateTime birthday_to)
{
       WebApplication.Person.PersonDS reportDS = new PersonDS();   WebApplication.PersonMain.PersonMain webServer = new                 PersonMain.PersonMain();   
DBTable dbt = new DBTable();    
    DataSet ds =webServer.PersonWS(birthday_from,birthday_to);
    dbt.addTableforReportDataSet(ds,"Person",reportDS);
    ReportDocument oRpt = new ReportDocument();
oRpt.Load(@"c:\inetpub\wwwroot\WebApplication\Person\Person.rpt");
    oRpt.SetDataSource(reportDS);
    return oRpt;
}  
....................
 
上面加载报表用的是绝对路径（加下划线），但在实际应用中我们普遍用的是相对路径，即：
string rpLoc = AppDomain.CurrentDomain.BaseDirectory +@"\Rp\Rp00076\Rp00076.rpt";
oRpt.Load(rpLoc);
 
4.4 数据显示

为显示数据是否被调用，我们可以新建一个Web页，在上面放入二个textbox用来传参，一个CrystalReportViewer用来显示CrystalReport，一个确定按钮。主要代码如下：
BeginPage.aspx：
....................
private void Button1_Click(object sender, System.EventArgs e)
{
    DateTime tb1 = Convert.ToDateTime(this.TextBox1.Text);
    DateTime tb2 = Convert.ToDateTime(this.TextBox2.Text);
    WebApplication.Person.PersonLoadData testLD = new PersonLoadData();
    this.crView.ReportSource=testLD.generateReport(tb1,tb2);
}

....................

5. 结束语

Web   Service是基于网络的、分布式的模块化组件，它执行特定的任务，遵守具体的技术规范，这些规范使得Web   Service能与其他兼容的组件进行互操作。它可以使用标准的互联网协议，像超文本传输协议HTTP和XML，将功能体现在互联网和企业内部网上。Web   Service平台是一套标准，它定义了应用程序如何在Web上实现互操作性。我们可以用我们喜欢的任何语言，在我们喜欢的任何平台上写Web   Service。