| title | description | author | ms.author | ms.date | ms.service | ms.subservice | ms.topic | ms.custom | helpviewer_keywords | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report Server Web service endpoints |
The Report Server Web service provides three endpoints for managing a report server and executing and navigating reports. |
maggiesMSFT |
maggies |
03/03/2017 |
reporting-services |
report-server-web-service |
reference |
updatefrequency5 |
|
The Report Server Web service provides several endpoints for managing a report server and executing and navigating reports.
There are three endpoints available for managing objects on a report server, xref:ReportService2005, xref:ReportService2006, and xref:ReportService2010. The xref:ReportService2005 endpoint is used for managing objects on a report server that is configured for native mode. The xref:ReportService2006 endpoint is used for managing objects on a report server that is configured for SharePoint integrated mode. The xref:ReportService2010 endpoint merges the functionalities of xref:ReportService2005 and xref:ReportService2006 and can manage objects on a report server that are configured for either native or SharePoint integrated mode.
Important
When a report server is configured for SharePoint integrated mode, the xref:ReportService2005 APIs will return an rsOperationNotSupportedSharePointMode error. If the report server is configured for native mode, the xref:ReportService2006 APIs will return an rsOperationNotSupportedNativeMode error. Similarly, when mode-specific APIs in xref:ReportService2010 are used on unintended modes, the APIs will return the respective errors.
Note
The xref:ReportService2005 and xref:ReportService2006 endpoints are deprecated in [!INCLUDEsql2008r2]. The xref:ReportService2010 endpoint includes the functionalities of both endpoints and contains additional management features.
If the report server is configured for native mode or SharePoint integrate mode, the WSDL for the management endpoint can be accessed by using one of the following URLs:
https://<Server Name>/ReportServer/ReportService2010.asmx?wsdl
For more information, see Accessing the SOAP API.
The xref:ReportExecution2005 endpoint makes it easy for developers to customize report processing and rendering from a report server in both native and SharePoint integrated modes. The endpoint includes classes and methods that existed in earlier versions of the Report Server Web service. In addition, many new classes and methods have been added to the Report Server Web service that are exposed through the execution endpoint.
The WSDL for the management endpoint can be accessed using the following URL:
https://<Server Name>/ReportServer/ReportExecution2005.asmx?wsdl
If the report server is configured for SharePoint integrate mode, the WSDL can be accessed using the following URL:
https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportExecution2005.asmx?wsdl
For more information, please see Accessing the SOAP API.
When a report server is configured for SharePoint integrated mode and the [!INCLUDEssRSnoversion] Add-in has been installed, a set of proxy endpoints are installed on the SharePoint server. The proxy endpoints are the primary API for developing report solutions when a report server is configured for SharePoint integrated mode. When you develop against the proxy endpoints, the [!INCLUDEssRSnoversion], Add-in manages the exchange of credentials between the SharePoint server and the report server in Trusted account authentication mode. When you develop against the report server endpoints, the calling application must manage the credential exchange in Trusted account authentication mode. The following table lists the endpoints that are installed with the [!INCLUDEssRSnoversion] Add-in.
| Proxy Endpoint | Description |
|---|---|
| xref:ReportService2006 | Provides the APIs for managing a report server that is configured for SharePoint integrate mode. Note: This endpoint is deprecated in [!INCLUDEsql2008r2]. |
| xref:ReportService2010 | Provides the APIs for managing a report server that is configured for either native or SharePoint integrated mode. |
| xref:ReportExecution2005 | Provides the APIs for running and navigating reports. |
| xref: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.
https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportService2010.asmx
https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportExecution2005.asmx
https://<Server Name>/<Site Name>/_vti_bin/ReportServer/ReportServiceAuthentication.asmx
Building Applications Using the Web Service and the .NET Framework