• Статья

Доступ к API-интерфейсу SOAP

Веб-служба сервера отчетов использует протокол SOAP по протоколу HTTP и выступает в роли интерфейса связи между клиентскими программами и сервером отчетов. Веб-служба предоставляет две конечные точки — одну для выполнения отчетов и другую для управления отчетами. Веб-служба состоит из методов и набора объектов сложного типа, которые можно использовать для доступа ко всем функциональным возможностям служб Службы Reporting Services. Для вызова службы следует создать ссылку на язык описания веб-служб (WSDL) служб Reporting Services.

Создание ссылок на язык WSDL для служб Reporting Services

Для успешного вызова веб-службы следует знать способ доступа к данной службе, поддерживаемые ей операции, параметры, ожидаемые этой службой, а также данные, которые она возвращает С помощью языка WSDL эти данные предоставляются в XML-документе, который может быть считан или обработан компьютером.

Веб-службы сервера отчетов доступны в трех различных конечных точках. Имя WSDL-файла у каждой конечной точки свое. Конечная точка ReportService2010 содержит методы для управления объектами в сервере отчетов как в собственном режиме, так и в режиме интеграции с SharePoint. Обратиться к WSDL-файлу данной конечной точки можно по адресу ReportService2010.asmx?wsdl..

ПримечаниеПримечание

Конечные точки ReportService2005 и ReportService2006 являются устаревшими в SQL Server 2008 R2. Конечная точка ReportService2010 содержит функциональные возможности обеих конечных точек, а также содержит дополнительные функции управления.
  • Конечная точка ReportExecution2005 позволяет разработчикам программным образом обрабатывать и подготавливать к просмотру отчеты на сервере отчетов. Обратиться к WSDL-файлу данной конечной точки можно по адресу ReportExecution2005.asmx?wsdl

WSDL-файл может быть использован средствами разработки, поддерживающими SOAP и веб-службы, например пакетом Microsoft .NET Framework SDK.

В следующем примере показывается формат URL-адреса управляющего WSDL-файла служб Службы Reporting Services:

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

В следующей таблице описывается каждый элемент URL-адреса.

Элемент URL-адреса

Описание

server

Имя сервера, на котором развернут сервер отчетов.

reportserver

Имя папки, в которой содержится веб-служба XML. Данный элемент настраивается во время установки.

<имя конечной точки>.asmx

Имя конечной точки веб-службы.

Дополнительные сведения о формате WSDL см. в спецификации языка WSDL консорциума World Wide Web (W3C) по адресу http://www.w3.org/TR/wsdl.