Freigeben über

Verwenden der SOAP-API in einer Windows-Anwendung

Sie können über die SOAP-API von Reporting Services auf die vollständige Funktionalität des Berichtsservers zugreifen. Die SOAP-API ist ein Webdienst, auf den Sie problemlos zugreifen können, um Unternehmensberichtsfunktionen für Ihre benutzerdefinierten Geschäftsanwendungen bereitzustellen. Sie können auf den Webdienst in einer Windows-Anwendung zugreifen, indem Sie einfach Code schreiben, der Aufrufe an den Dienst sendet. Mithilfe von Microsoft .NET Framework können Sie eine Proxyklasse generieren, die die Eigenschaften und Methoden des Webdiensts verfügbar macht und Ihnen die Verwendung einer vertrauten Infrastruktur und Tools ermöglicht, um Geschäftsanwendungen zu erstellen, die auf reporting Services-Technologie basieren.

Integrieren von Berichtsverwaltungsfunktionen mithilfe von Windows Forms

Im Gegensatz zum URL-Zugriff macht die SOAP-API den vollständigen Satz von Verwaltungsfunktionen verfügbar, die über den Berichtsserver verfügbar sind. Dies bedeutet, dass die gesamte administrative Funktionalität des Berichts-Managers entwicklern über SOAP zur Verfügung steht. So können Sie ein vollständiges Verwaltungs- und Verwaltungstool mit Windows Forms entwickeln. In Ihrer Windows-Anwendung können Sie es Ihren Benutzern beispielsweise ermöglichen, den Inhalt des Berichtsservernamespaces abzurufen. Dazu können Sie die Webdienstmethode ListChildren verwenden, um alle Elemente in der Berichtsserverdatenbank aufzulisten und dann ein Listview-, Treeview- oder Combobox-Steuerelement zu verwenden, um diese Elemente ihren Benutzern anzuzeigen. Der folgende Webdienstcode kann verwendet werden, um die aktuelle Liste der verfügbaren Berichte im Ordner "Meine Berichte" eines Benutzers abzurufen, wenn ein Benutzer auf eine Schaltfläche in einem Formular klickt:

' Button click event that retrieves a list of reports from  
' the My Reports folder and displays them in a combo box  
Private Sub listReportsButton_Click(sender As Object, e As System.EventArgs)  
   ' Create a new Web service object and set credentials  
   ' to Windows Authentication  
   Dim rs As New ReportingService2010()  
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials  
  
   ' Return the list of items in My Reports  
   Dim items As CatalogItem() = rs.ListChildren("/Adventureworks 2008 Sample Reports", False)  
  
   Dim ci As CatalogItem  
   For Each ci In  items  
      ' If the item is a report, add it to   
      ' a combo box  
      If ci.TypeName = "Report" Then  
         catalogComboBox.Items.Add(ci.Name)  
      End If  
   Next ci  
End Sub 'listReportsButton_Click  

// Button click event that retrieves a list of reports from  
// the My Reports folder and displays them in a combo box  
private void listReportsButton_Click(object sender, System.EventArgs e)  
{  
   // Create a new Web service object and set credentials  
   // to Windows Authentication  
   ReportingService2010 rs = new ReportingService2010();  
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  
  
   // Return the list of items in My Reports  
   CatalogItem[] items = rs.ListChildren("/Adventureworks 2008 Sample Reports", false);  
  
   foreach (CatalogItem ci in items)  
   {  
      // If the item is a report, add it to   
      // a combo box  
      if (ci.TypeName == "Report")  
         catalogComboBox.Items.Add(ci.Name);  
   }  
}

Von dort aus können Sie Benutzern das Auswählen des Berichts aus dem Kombinationsfeld ermöglichen und den Bericht im Formular entweder mithilfe eines Webbrowser-Steuerelements oder eines Bildsteuerelements in der Vorschau anzeigen.

Aktivieren der Berichtsanzeige und -navigation mithilfe von Windows Forms

Es gibt zwei Methoden zum Integrieren von Berichten in Ihre Windows Forms-Anwendungen.

Sie können die SOAP-API verwenden, um Berichte in einem der unterstützten Renderingformate mithilfe der Render Methode zu rendern. Es gibt leichte Nachteile zum Aktivieren der Berichtsanzeige und -navigation über SOAP:

  • Sie können die integrierte Funktionalität der Berichtssymbolleiste, die im HTML-Viewer enthalten ist, nicht über DEN URL-Zugriff nutzen.

  • Wenn Sie in HTML rendern, müssen Sie alle Bilder oder Ressourcen separat als zusätzliche Datenströme mithilfe der RenderStream Methode rendern.

  • Es gibt einen leichten Leistungsvorteil beim Rendern von Berichten mithilfe des URL-Zugriffs über die SOAP-API.

Die Methode der SOAP-API kann jedoch verwendet werden, Render um Berichte zu rendern und programmgesteuert in verschiedenen Ausgabeformaten zu speichern. Dies ist ein Vorteil gegenüber dem URL-Zugriff, der eine Benutzerinteraktion erfordert. Wenn Sie einen Bericht mit der SOAP-API-Methode Render rendern, können Sie in einem der unterstützten Ausgabeformate rendern.

Sie können auch die frei verteilten ReportViewer-Steuerelemente verwenden, die in Microsoft Visual Studio 2008 enthalten sind. Die ReportViewer-Steuerelemente erleichtern das Einbetten von Reporting Services-Funktionen in benutzerdefinierte Anwendungen. Die ReportViewer-Steuerelemente sind für Entwickler vorgesehen, die vordefinierte, vollständig erstellte Berichte als Teil eines Anwendungsfeaturesatzes bereitstellen möchten (z. B. kann eine Websiteverwaltungsanwendung Berichte enthalten, die Klickstreamanalyse auf Unternehmenswebsites anzeigen). Das Einbetten der Steuerelemente in eine Anwendung bietet eine optimierte Alternative zum Einschließen der Reporting Services-Serverkomponenten in Ihre Anwendungsbereitstellung. Die Steuerelemente bieten Berichtsfunktionen, aber ohne zusätzliche Berichtserstellung, Publikation oder Verteilungs- und Übermittlungsunterstützung, die Sie in Reporting Services finden.

Es gibt zwei Versionen der ReportViewer-Steuerelemente, eine für Rich Windows-Clientanwendungen und eine für ASP.NET Anwendungen. Die Steuerelemente unterstützen sowohl lokale Verarbeitungs- als auch Remoteverarbeitungsmodi. Im lokalen Verarbeitungsmodus stellt Ihre Anwendung die Berichtsdefinition und -datasets bereit und löst die Berichtsverarbeitung aus. Im Remoteverarbeitungsmodus erfolgt der Datenabruf und die Berichtsverarbeitung auf dem Berichtsserver, und das Steuerelement wird für die Anzeige- und Berichtsnavigation verwendet. Mit diesem Modell können Sie umfangreiche Anwendungen erstellen, die vom Desktop auf das Unternehmen skaliert werden können.

ReportViewer-Steuerelemente sind in der Visual Studio-Onlinehilfe dokumentiert. Weitere Informationen finden Sie in der Visual Studio-Produktdokumentation.

Siehe auch

Erstellen von Anwendungen mit dem Webdienst und .NET Framework
Integrieren von Reporting Services in Anwendungen
Verwenden der SOAP-API in einer Webanwendung

  • Last updated on