访问 SOAP API

报表服务器 Web 服务使用通过 HTTP 的简单对象访问协议 (SOAP),并充当客户端程序和报表服务器之间的通信接口。该 Web 服务提供两个端点(一个用于报表执行,一个用于报表管理),并且由您可用于访问 Reporting Services 的完整功能的方法和一组复杂类型对象构成。若要调用该服务,必须引用 Reporting Services Web 服务描述语言 (WSDL)。

引用 Reporting Services WSDL

若要成功调用某一 Web 服务,您必须知道如何访问该服务、该服务支持的操作、该服务预期的参数以及该服务返回的内容。WSDL 在可由计算机读取或处理的 XML 文档中提供这些信息。

该报表服务器 Web 服务在三个不同的端点中公开。该 WSDL 文件的名称对于每个端点并不相同。ReportService2010 端点包含一些方法,用于管理本机模式或 SharePoint 集成模式下报表服务器中的对象。用于此端点的 WSDL 通过 ReportService2010.asmx?wsdl. 访问。

注意注意

在 SQL Server 2008 R2 中不推荐使用 ReportService2005ReportService2006 端点。ReportService2010 端点包含两个端点的功能和其他管理功能。

  • ReportExecution2005 端点允许开发人员以编程方式在报表服务器中处理和呈现报表。用于此端点的 WSDL 通过 ReportExecution2005.asmx?wsdl 访问。

WSDL 可由支持 SOAP 和 Web 服务的开发包(例如 Microsoft .NET Framework SDK)使用。

以下示例显示指向 Reporting Services 管理 WSDL 文件的 URL 的格式:

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

下表介绍 URL 中的各元素。

URL 元素

说明

server

报表服务器部署到的服务器的名称。

reportserver

包含 XML Web 服务的文件夹的名称。此名称在设置期间配置。

<端点名称>.asmx

Web 服务端点的名称。

有关 WSDL 格式的详细信息,请参阅万维网联合会 (W3C) WSDL 规范,网址为 http://www.w3.org/TR/wsdl。