[翻译]如何使用webservice作为数据源去生成Microsoft Reporting Services 2005的报表

原文地址： http://www.codeproject.com/KB/reporting-services/WebAndReportingServices.aspx
[原文源码下载]

[翻译]如何使用webservice作为数据源去生成Microsoft Reporting Services 2005的报表

原文发布日期：2006.05.18
作者： Dimitar Madjarov
翻译： webabcd

介绍
好几个月的时间了，我一直在学习Microsoft Reporting Services 2005的一些新的功能。其中之一就是如何使用webservice作数据源。但是很不幸，我无法在MSDN和sql Server 2005的相关书籍中找到详细的帮助信息。所以我花了好长时间来搞定这个问题。希望通过分享我的Microsoft Reporting Services 2005的相关知识能够节省你的开发时间。


新建一个webservice
第一步是新建一个webservice，稍后我将用这个webservice作为我的报表的数据源。这是非常重要的一步，因为我们要将数据转换成一个XmlDataDocument。如果没有这步转换，我们将不能得到使用webservice的web方法取得数据的结果。实现这个转换的C#代码如下：

[WebMethod]

public  XmlDataDocument GetPersonAddress( string  cityNameID)

{

   //

   // 定义一些变量

   //   

   StringBuilder   myQuery           = new StringBuilder();

   XmlDataDocument resultXMLDocument = new XmlDataDocument();

   sqlConnection   myConnection      = new sqlConnection();

   sqlCommand      myCommand         = new sqlCommand();

   sqlDataAdapter  myDA              = new sqlDataAdapter();

   DataSet         myDS              = new DataSet();

   

   //

   // 根据参数的不同准备不同的查询语句

   //   

   if ((cityNameID != null) && (cityNameID.Trim() != ""))

   

{

    myQuery.Append("Select City as City, " + 

                   "AddressLine1 as Address, " + 

                   "PostalCode From Address ");

    myQuery.Append("Where City Like '" + 

                   cityNameID.Trim().Replace("%", "") + 

                   "%' Order By City");

   }

   else

   

{

    myQuery.Append("Select City as City, AddressLine1" + 

                   " as Address, PostalCode From Address" + 

                   " Order By City");

   }

   

   //

   // 得到连接字符串并建立到服务器的连接

   //   

   myConnection.ConnectionString = ReadSetting("ConnectionString", "");

   myCommand.Connection          = myConnection;

   myCommand.CommandText         = myQuery.ToString();

   myCommand.CommandType         = CommandType.Text;

   myDA.SelectCommand            = myCommand;

   

   //

   // 返回一个DataSet数据

   //   

   try

   

{

      myDA.Fill(myDS, "Address");

      

      //

      // 转换我们的DataSet到XmlDataDocument

      //

      XmlDataDocument temporaryXMLDoc = new XmlDataDocument(myDS);

      resultXMLDocument = temporaryXMLDoc;

      temporaryXMLDoc = null;

    }

    catch

    

{

       resultXMLDocument = null;

    }

    finally

    

{

       myDS.dispose();

       myDA.dispose();

       myCommand.dispose();

       myConnection.dispose();

       myQuery = null;

    }

   return resultXMLDocument;

}

最后我们在IIS中发布这个webservice，因为我们是使用VS2005开发的，如果你的电脑里还装了VS2003，那么你应该检查一下你的虚拟目录关联的服务是否是.net 2.0


使用这个webservice作为数据源创建和部署报表
我们的下一步就是用Microsoft Reporting Services 2005创建一个报表，其使用的数据源就是我们第一步所创建的那个webservice。要完成这个任务，你的电脑里需要安装Microsoft sql Server 2005的Microsoft Reporting Services。我们先新建一个名为“TestReport”的报表服务器项目。之后，我们添加一个共享数据源，将其类型设置为XML，连接字符串就是我们的webservice的地址。然后添加一个新报表，本例中webservice的命名空间是“http://madjarov_d_n_demo.org”，方法是“GetPersonAddress”
图1

图2

最后，你选择下一步并生成报表。这样报表就可以在sql Server 2005和VS2005 Studio中设计了，图例如下：
图3

我们如何给webservice中的方法GetPersonAddress(string cityNameID)传参数呢？微软为开发人员提供了一个强大的报表引擎。我们可在Microsoft Reporting Services 2005中非常容易的设置它。首先我们要在设计模式中选择报表参数，然后增加一个数据类型为“string”，名为“cityNameID”的参数，图例如下：
图4

最后一步就是把这个报表参数和DataSet关联起来。为了达到这个目的，我们需要在设计模式中编辑数据源，首先新建一个DataSet，参数名为“cityNameID”，它的值为“Parameters!cityNameID.Value”，图例如下：
图5

现在我们就可以在报表服务器中部署报表了。在部署之前你要确保你的“TargetReport Folder”和“TargetReport Server”被设置成了正确的值。你可以在报表属性中设置它们，图例如下：
图6

现在你就可以把它部署到报表服务器了。


给我们的报表创建一个简单的视图
我们最后的任务就是创建一个视图程序，它负责从报表中获取结果然后展现给我们。为了在这里传送一个参数到报表里，我们在VS2005(C#)中创建了一个名为“TestReportWebViewer”的web站点，并把“Default.aspx”做我们web站点的默认页，然后从工具箱里把“ReportView”控件拖拽到我们的页上。最后给它设置一个合适的大小并如下图设置该控件其它的属性。
图7

请注意一定要把“ReportPath”和“reportserverUrl”设置成我们之前部署报表时的相同的值，否则我们的“ReportView”控件将不会显示我们的报表。下面是“ReportView”控件的“Init”事件的源代码：

protected   void  rptViewer_Init( object  sender, EventArgs e)

{ 

 //

 // 创建一个报表参数，并初始化它的值为“Al”

 //   

 ReportParameter cityID   = new ReportParameter();

 cityID.Name              = "cityNameID";

 cityID.Values.Add("Al"); 

 

 //

 // 设置“ReportView”控件的处理模式为“Remote”

 //   

 rptViewer.ProcessingMode = ProcessingMode.Remote;

    

 //

 // 传送参数并初始化“ReportView”控件

 //   

 rptViewer.ServerReport.SetParameters(new ReportParameter[] 

{ cityID });

}

最后，谢谢你能看到这里。希望当你尝试在Microsoft Reporting Services 2005项目中使用webservice作数据源的时候本文能给你带来一些帮助。你可以下载本文提供的源码仔细看其实现的过程。 感谢我的同事Mr. Svilen Donev给我提供了很多有价值的信息。