Uzyskiwanie dostępu do API SOAP

Usługa Report Server korzysta z protokołu Simple Object Access Protocol (SOAP) przez HTTP i pełni funkcję interfejsu komunikacyjnego między programami klienckimi a serwerem raportów. Usługa Web oferuje dwa punkty końcowe – jeden do wykonywania raportów, drugi do zarządzania raportami – i składa się z metod oraz zestawu złożonych obiektów typów, które pozwalają uzyskać dostęp do pełnej funkcjonalności Reporting Services. Aby zadzwonić do usługi, należy odwołać się do języka opisu usług internetowych Reporting Services (WSDL).

Odniesienie do Reporting Services WSDL

Aby skutecznie wywołać usługę internetową, musisz wiedzieć, jak uzyskać dostęp do usługi, jakie operacje obsługuje usługa, jakie parametry oczekuje i co usługa zwraca. WSDL dostarcza te informacje w dokumencie XML, który może być odczytywany lub przetwarzany przez komputer.

Usługi Web Report Server są dostępne w trzech różnych punktach końcowych. Nazwa pliku WSDL różni się dla każdego punktu końcowego. Punkt końcowy ReportService2010 zawiera metody zarządzania obiektami w Report Server w trybie natywnym lub zintegrowanym SharePoint. Dostęp do WSDL tego punktu końcowego jest dostępny przez ReportService2010.asmx?wsdl.

Note

Endpointy ReportService2005 and ReportService2006 są wycofane w SQL Server 2008 R2 (10.50.x). Punkt ReportService2010 końcowy zawiera funkcjonalności obu punktów oraz dodatkowe funkcje zarządzania.

  • Endpoint pozwala ReportExecution2005 programowo przetwarzać i renderować raporty na serwerze raportów. Do WSDL tego punktu końcowego dostęp jest dostępny przez ReportExecution2005.asmx?wsdl.

WSDL może być używany przez zestawy programistyczne obsługujące SOAP i usługi sieciowe, takie jak Microsoft .NET Framework SDK.

Poniższy przykład pokazuje format adresu URL do pliku WSDL zarządzania Reporting Services:

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

Poniższa tabela opisuje każdy element w URL.

Element URL Description
serwer Nazwa serwera, na którym wdrożony jest serwer raportów.
Raport Nazwa folderu zawierającego usługę XML Web Service. Konfiguruje się to podczas konfiguracji.
<Endpoint name.asmx> Nazwa endpointu usługi webowej.

Więcej informacji o formacie WSDL można znaleźć w specyfikacji WSDL World Wide Web Consortium (W3C) pod adresem http://www.w3.org/TR/wsdl.

Treści powiązane

  • Last updated on