Using the SOAP API in a SharePoint Application

A new set of endpoints have been provided with the installation of Reporting Services that will allow development of reporting solutions that are tightly integrated with Microsoft Windows SharePoint Services 3.0 or later, as well as Microsoft Office SharePoint Server 2007 or later. These endpoints are installed by both the Reporting Services installation as well as the Reporting Services Add-in for SharePoint Technologies. For more information about how to configure Reporting Services in SharePoint integrated mode see Configuring Reporting Services for SharePoint 2010 Integration.

Report Server Endpoints

The ReportService2005 endpoint provides the management APIs for a report server that is configured for native mode, and the ReportService2006 endpoint provides the management APIs for a report server that is configured for SharePoint integrated mode. In SQL Server 2008 R2, a new endpoint called ReportService2010 can manage a report server that is configured for either native mode or SharePoint integrated mode.

Important

When a report server is configured for SharePoint integrated mode, the ReportService2005 APIs will return an rsOperationNotSupportedSharePointMode error. If the report server is configured for native mode, the ReportService2006 APIs will return an rsOperationNotSupportedNativeMode error. Similarly, if a mode-specific API in ReportService2010 is used on a report server in an incompatible mode, the API will return the respective error.

The ReportExecution2005 endpoint will continue to work in both native and SharePoint integrated modes. The following is an example URL for referencing the ReportService2010 endpoint on a report server.

http://<Server Name>/ReportServer/ReportService2010.asmx

SharePoint Proxy Endpoints

In addition to the report server endpoints, a set of proxy endpoints are installed on the SharePoint server when the Reporting Services Add-in is installed. The proxy endpoints are the primary API for developing report solutions when a report server is configured for SharePoint integrated mode. When developing against the proxy endpoints the Reporting Services add-in handles the exchange of credentials between the SharePoint server and the report server in Trusted account authentication mode. When developing against the report server endpoints, the calling application will have to manage the credential exchange in Trusted account authentication mode. The following table lists the endpoints that are installed with the Reporting Services Add-in.

Proxy Endpoint

Description

ReportService2006

Provides the APIs for managing a report server that is configured for SharePoint integrate mode.

ReportService2010

Provides the APIs for managing a report server that is configured for either native mode or SharePoint integrate mode.

ReportExecution2005

Provides the APIs for execution and navigation of reports.

ReportServiceAuthentication

Provides the APIs for authenticating users against a report server when the SharePoint Web Application is configured for Forms Authentication.

The following are example URLs for referencing the proxy endpoints on a SharePoint site.

http://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportService2010.asmx

http://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportExecution2005.asmx

http://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportServiceAuthentication.asmx