访问 SOAP APIAccessing the SOAP API

报表服务器 Web 服务使用通过 HTTP 的简单对象访问协议 (SOAP),并充当客户端程序和报表服务器之间的通信接口。The Report Server Web service uses Simple Object Access Protocol (SOAP) over HTTP and acts as a communications interface between client programs and the report server. 该 Web 服务提供两个端点(一个用于报表执行,一个用于报表管理),并且由您可用于访问 Reporting ServicesReporting Services 的完整功能的方法和一组复杂类型对象构成。The Web service provides two endpoints - one for report execution and one for report management - and consists of methods and a set of complex type objects that you can use to access the complete functionality of Reporting ServicesReporting Services. 若要调用该服务,必须引用 Reporting Services Web 服务描述语言 (WSDL)。To call the service, you must reference the Reporting Services Web Services Description Language (WSDL).

引用 Reporting Services WSDLReferencing the Reporting Services WSDL

若要成功调用某一 Web 服务,您必须知道如何访问该服务、该服务支持的操作、该服务预期的参数以及该服务返回的内容。To call a Web service successfully, you must know how to access the service, what operations the service supports, what parameters the service expects, and what the service returns. WSDL 在可由计算机读取或处理的 XML 文档中提供这些信息。WSDL provides this information in an XML document that can be read or processed by a computer.

该报表服务器 Web 服务在三个不同的端点中公开。The Report Server Web services are exposed in three different endpoints. 该 WSDL 文件的名称对于每个端点并不相同。The name of the WSDL file is different for each endpoint. ReportService2010 端点包含一些方法,用于管理本机模式或 SharePoint 集成模式下报表服务器中的对象。The ReportService2010 endpoint contains methods for managing objects in a Report Server in either native or SharePoint integrated mode. 用于此端点的 WSDL 通过 ReportService2010.asmx?wsdl. 访问。The WSDL for this endpoint is accessed through ReportService2010.asmx?wsdl.

备注

SQL Server 2008 R2SQL Server 2008 R2 中不推荐使用 ReportService2005ReportService2006 端点。The ReportService2005 and ReportService2006 endpoints are deprecated in SQL Server 2008 R2SQL Server 2008 R2. ReportService2010 端点包含两个端点的功能和其他管理功能。The ReportService2010 endpoint includes the functionalities of both endpoints and contains additional management features.

  • ReportExecution2005 端点允许开发人员以编程方式在报表服务器中处理和呈现报表。The ReportExecution2005 endpoint allows developers to programmatically process and render reports in a Report Server. 用于此端点的 WSDL 通过 ReportExecution2005.asmx?wsdl 访问。The WSDL for this endpoint is accessed through ReportExecution2005.asmx?wsdl.

WSDL 可由支持 SOAP 和 Web 服务的开发包(例如 MicrosoftMicrosoft .NET Framework.NET Framework SDK)使用。WSDL can be consumed by development kits that support SOAP and Web services, such as the MicrosoftMicrosoft .NET Framework.NET Framework SDK.

以下示例显示指向 Reporting ServicesReporting Services 管理 WSDL 文件的 URL 的格式:The following example shows the format of the URL to the Reporting ServicesReporting Services management WSDL file:

https://server/reportserver/ReportService2010.asmx?wsdl  

下表介绍 URL 中的各元素。The following table describes each element in the URL.

URL 元素URL element 说明Description
服务器 server 报表服务器部署到的服务器的名称。The name of the server on which the report server is deployed.
reportserver reportserver 包含 XML Web 服务的文件夹的名称。The name of the folder that contains the XML Web service. 此名称在设置期间配置。This is configured during setup.
<endpoint name>.asmx<endpoint name>.asmx Web 服务端点的名称。The name of the web service endpoint.

有关 WSDL 格式的详细信息,请参阅万维网联合会 (W3C) WSDL 规范,网址为 http://www.w3.org/TR/wsdlFor more information about the WSDL format, see the World Wide Web Consortium (W3C) WSDL specification at http://www.w3.org/TR/wsdl.

另请参阅See Also

使用 Web 服务和 .NET Framework 生成应用程序 Building Applications Using the Web Service and the .NET Framework
报表服务器 Web 服务Report Server Web Service