• Artículo

Acceso a la API SOAP

El servicio web del servidor de informes utiliza el Protocolo simple de acceso a objetos (SOAP) sobre HTTP y actúa como interfaz de comunicaciones entre los programas clientes y el servidor de informes. El servicio web proporciona dos extremos, uno para la ejecución y otro para la administración de informes, y está compuesto de métodos y de un conjunto de objetos de tipo complejo que puede utilizar para tener acceso a la funcionalidad completa de Reporting Services. Para llamar al servicio, debe hacer referencia al Lenguaje de descripción de servicios web (WSDL) de Reporting Services.

Referencia a WSDL de Reporting Services

Para llamar correctamente a un servicio web, debe saber cómo tener acceso al mismo, qué operaciones admite, qué parámetros espera y lo que devuelve. WSDL proporciona esta información en un documento XML que un equipo puede leer o procesar.

Los servicios web del servidor de informes se exponen en tres extremos diferentes. El nombre del archivo WSDL es diferente para cada extremo. El extremo ReportService2010 contiene métodos para administrar los objetos en un servidor de informes en modo nativo o en modo integrado de SharePoint. El acceso a WSDL para este extremo se realiza a través de ReportService2010.asmx?wsdl..

Nota

Los tipos de datos ReportService2005 y ReportService2006 están desusados en SQL Server 2008 R2. El extremo ReportService2010 incluye las funcionalidades de ambos extremos y contiene características de administración adicionales.

  • El extremo ReportExecution2005 permite a los desarrolladores procesar y representar mediante programación los informes en un servidor de informes. El acceso a WSDL para este extremo se realiza a través de ReportExecution2005.asmx?wsdl.

Los kits de desarrollo que admiten SOAP y servicios web, como Microsoft .NET Framework SDK, pueden usar el WSDL.

En el siguiente ejemplo se muestra el formato de la dirección URL del archivo WSDL de Reporting Services.

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

En la tabla siguiente se describe cada elemento de la dirección URL.

Elemento de dirección URL

Descripción

server

Nombre del servidor donde se implementa el servidor de informes.

reportserver

Nombre de la carpeta que contiene el servicio web XML. Se configura durante la instalación.

<nombre de extremo>.asmx

Nombre del extremo de servicios web.

Para obtener más información acerca del formato de WSDL, vea la especificación de WSDL del World Wide Web Consortium (W3C) en http://www.w3.org/TR/wsdl.