[翻译]如何使用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给我提供了很多有价值的信息。