Verwenden der SOAP-API in einer Webanwendung

Sie können über die SOAP-API von Reporting Services auf die vollständige Funktionalität des Berichtsservers zugreifen. Da es sich um einen Webdienst ist, kann auf die SOAP-API problemlos zugegriffen werden, um Unternehmensberichtsfeatures für Ihre benutzerdefinierten Geschäftsanwendungen bereitzustellen. Sie greifen auf den Report Server-Webdienst von einer Webanwendung auf die gleiche Weise wie auf die SOAP-API aus einer Microsoft Windows-Anwendung zu. Mithilfe von Microsoft .NET Framework können Sie eine Proxyklasse generieren, die die Eigenschaften und Methoden des Report Server-Webdiensts verfügbar macht und Ihnen die Verwendung einer vertrauten Infrastruktur und Tools ermöglicht, um Geschäftsanwendungen auf Reporting Services-Technologie zu erstellen.

Die Berichtsverwaltungsfunktionalität von Reporting Services ist genauso einfach über eine Webanwendung wie über eine Windows-Anwendung zugegriffen werden kann. Aus einer Webanwendung können Sie Elemente aus der Berichtsserverdatenbank hinzufügen und entfernen, Elementsicherheit festlegen, Berichtsserverdatenbankelemente ändern, Terminplanung und Übermittlung verwalten und vieles mehr.

Aktivieren des Identitätswechsels

Der erste Schritt beim Konfigurieren Ihrer Webanwendung besteht darin, den Identitätswechsel vom Webdienstclient zu aktivieren. Bei Identitätswechsel können ASP.NET Anwendungen mit der Identität des Clients ausgeführt werden, in dessen Auftrag sie tätig sind. ASP.NET basiert auf Microsoft Internetinformationsdienste (IIS), um den Benutzer zu authentifizieren und entweder ein authentifiziertes Token an die ASP.NET Anwendung zu übergeben oder, wenn der Benutzer nicht authentifiziert werden kann, ein nicht authentifiziertes Token übergeben. In beiden Fällen gibt die ASP.NET Anwendung an, welches Token empfangen wird, wenn der Identitätswechsel aktiviert ist. Sie können den Identitätswechsel auf dem Client aktivieren, indem Sie die Web.config Datei der Clientanwendung wie folgt ändern:

<!-- Web.config file. -->  
<identity impersonate="true"/>  

Weitere Informationen zu ASP.NET Identitätswechsel finden Sie in der Dokumentation zum Microsoft .NET Framework SDK.

Verwalten des Berichtsservers mit SOAP-API

Sie können ihre Webanwendung auch verwenden, um einen Berichtsserver und dessen Inhalt zu verwalten. Der Berichts-Manager, der in Reporting Services enthalten ist, ist ein Beispiel für eine Webanwendung, die vollständig mithilfe von ASP.NET und der Reporting Services-SOAP-API erstellt wurde. Sie können den benutzerdefinierten Webanwendungen die Berichtsverwaltungsfunktionen des Berichts-Managers hinzufügen. Sie können beispielsweise eine Liste der verfügbaren Berichte in der Berichtsserverdatenbank zurückgeben und in einem ASP.NET Listbox Steuerelement anzeigen, aus dem Ihre Benutzer auswählen können. Der folgende Code stellt eine Verbindung mit der Berichtsserverdatenbank und gibt eine Liste der Elemente in der Berichtsserverdatenbank zurück. Die verfügbaren Berichte werden dann einem Listbox-Steuerelement hinzugefügt, das den Pfad jedes Berichts anzeigt.

Private Sub Page_Load(sender As Object, e As System.EventArgs)  
   ' Create a Web service proxy object and set credentials  
   Dim rs As New ReportingService2005()  
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials  
  
   ' Return a list of catalog items in the report server database  
   Dim items As CatalogItem() = rs.ListChildren("/", True)  
  
   ' For each report, display the path of the report in a Listbox  
   Dim ci As CatalogItem  
   For Each ci In  items  
      If ci.Type = ItemTypeEnum.Report Then  
         catalogListBox.Items.Add(ci.Path)  
      End If  
   Next ci  
End Sub ' Page_Load   

private void Page_Load(object sender, System.EventArgs e)  
{  
   // Create a Web service proxy object and set credentials  
   ReportingService2005 rs = new ReportingService2005();  
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  
  
   // Return a list of catalog items in the report server database  
   CatalogItem[] items = rs.ListChildren("/", true);  
  
   // For each report, display the path of the report in a Listbox  
   foreach(CatalogItem ci in items)  
   {  
      if (ci.Type == ItemTypeEnum.Report)  
         catalogListBox.Items.Add(ci.Path);  
   }  
}  

Siehe auch

Erstellen von Anwendungen mit dem Webdienst und .NET Framework
Integrieren von Reporting Services in Anwendungen
Berichts-Manager (einheitlicher SSRS-Modus)
Verwenden der SOAP-API in einer Windows-Anwendung