Lektion 1: Definieren eines Berichtsdatasets für einen Reporting Services-Webdienst

  • Artikel

Aktualisiert: 14. April 2006

Führen Sie die folgenden Schritte aus, um zu lernen, wie eine Datenquellenverbindung angegeben wird und XML-Daten von einem Webdienst zurückgegeben werden. In dieser Lektion erstellen Sie ein Dataset, indem Sie die ListChildren-Methode des Berichtsserver-Webdienstes aufrufen, die eine Liste aller Elemente aus dem Stammordner in der Berichtsserver-Datenbank zurückgibt. Sie definieren die Parameter, die für die ListChildren-Methode erforderlich sind, und legen Standardwerte fest, um die Hierarchie, beginnend beim Stammordner, zu durchlaufen. Elementeigenschaften, die vom Webdienst definiert wurden, werden im Fenster Datasets als Felder für das Dataset angezeigt. Im letzten Schritt ziehen Sie die Datasetfelder in das Berichtslayout, um den Bericht zu entwerfen. Wenn Sie eine Vorschau des Berichts anzeigen, werden Elemente und Elementeigenschaften aus der Berichtsserver-Datenbank angezeigt, z. B. Berichte, Ordner und Datenquellen.

So definieren Sie eine XML-Datenquelle, ein XML-Dataset und eine XML-Abfrage

  1. Öffnen Sie ein Browserfenster, und geben Sie https://localhost/reportserver/reportservice2005.asmx?wsdl ein, um die Namespaceinformationen für den Berichtsserver-Webdienst abzurufen. Später geben Sie den Namespace in der Abfrage an.

    ms345338.note(de-de,SQL.90).gifHinweis:
    Wenn daraufhin keine Antwort in Form einer XML WSDL-Definition im Browser angezeigt wird, sollten Sie den Anforderungsabschnitt in Lernprogramm: Verwenden von XML-Daten in einem Bericht überprüfen.
    ms345338.note(de-de,SQL.90).gifHinweis:
    Versionsinformationen für Namespaces können von einer Version zur nächsten geändert werden. Zum Überprüfen der Namespaceinformationen für den verwendeten Berichtsserver können Sie die WSDL generieren und den Webdienstverweis auf seine Richtigkeit überprüfen. Das Format des Namespaces lautet https://schemas.microsoft.com/sqlserver/<year>/<month>/<day>/reporting/reportingservices.

  2. Starten Sie den Berichts-Designer, und erstellen Sie einen neuen Bericht. Wenn Sie nicht wissen, wie ein Bericht erstellt wird, finden Sie unter Lernprogramm: Erstellen eines einfachen Berichts weitere Informationen.

  3. Wählen Sie in der Datenansicht die Option Neues Dataset aus. Geben Sie einen Namen für das Dataset ein (z. B. XMLDataSet).

  4. Wählen Sie im Dialogfeld Dataset in Datenquelle die Option Neue Datenquelle aus. Das Dialogfeld Datenquelle wird angezeigt.

  5. Geben Sie einen Namen für die Datenquelle ein (z. B. XMLDataSource).

  6. Wählen Sie in Typ die Option XML aus.

  7. Geben Sie unter Verbindungszeichenfolge die folgende URL zum Berichtsserver-Webdienst ein:

    https://localhost/reportserver/reportservice2005.asmx

    Das Dialogfeld sollte ungefähr der folgenden Abbildung entsprechen:

    Screenshot eines XML-Datenquellentyps

    ms345338.note(de-de,SQL.90).gifHinweis:
    Verwenden Sie in SQL Server 2005 Reporting Services (SSRS) Service Pack 2 (SP2) und höheren Versionen die folgende Verbindungszeichenfolge für einen Berichtsserver, der im integrierten SharePoint-Modus ausgeführt wird: http://<servername>/_vti_bin/ReportServer/ReportService2006.asmx

  8. Wählen Sie auf der Registerkarte Anmeldeinformationen die Option Windows-Authentifizierung verwenden (integrierte Sicherheit) aus.

  9. Klicken Sie auf OK, um die Änderungen zu speichern, und schließen Sie das Dialogfeld Datenquelle.

  10. Geben Sie im Dialogfeld Dataset die folgende Abfrage ein. Verwenden Sie dabei die Versionsinformationen für den Namespace, die Sie in Schritt 1 überprüft haben:

    <Query>
<SoapAction>https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/ListChildren</SoapAction>
</Query>

    Das Dialogfeld sollte ungefähr der folgenden Abbildung entsprechen:

    Screenshot zu einem XML-Dataset

  11. Geben Sie auf der Registerkarte Parameter des Dialogfelds Dataset zwei Parameter ein. Hierbei handelt es sich um die Parameter für die ListChildren-Methode, die den Startpunkt in der Berichtsserver-Ordnerhierarchie angeben und festlegen, ob alle geschachtelten Ordner einbezogen werden sollen:

    Item

    Recursive

    ms345338.note(de-de,SQL.90).gifHinweis:
    In SP2 und höheren Versionen ist nur der Item-Parameter verfügbar.

  12. Legen Sie Item auf / fest. Entfernen Sie das vom Berichts-Designer hinzugefügte Zeichen "=". Das Symbol / gibt den Stammknoten für den Ordnernamespace des Berichtsservers an.

    ms345338.note(de-de,SQL.90).gifHinweis:
    Wenn Sie in SP2 oder einer höheren Version Reporting Services im integrierten SharePoint-Modus ausführen, muss der Parameter eine URL sein, die die SharePoint-Stammwebsite, den SharePoint-Ordner oder die SharePoint-Dokumentbibliothek angibt. Beispiel: http://<servername>/<top level site>, http://<servername>/<top level site>/<folder> oder http://<servername>/<top level site>/<document library>.

  13. Legen Sie Recursive auf 1 fest. Entfernen Sie das vom Berichts-Designer hinzugefügte Zeichen "=".

    Das Dialogfeld sollte ungefähr der folgenden Abbildung entsprechen:

    Screenshot zu einem XML-Dataset mit Parametern

  14. Klicken Sie auf OK. Das Dataset wird dem Fenster Datasets hinzugefügt.

  15. Klicken Sie auf Ausführen (!), um das Resultset anzuzeigen. Wenn die Berichtsserver-Datenbank Berichte und andere Elemente enthält, sollte für jedes Element eine Datenzeile angezeigt werden.

    ms345338.note(de-de,SQL.90).gifHinweis:
    Wenn der Fehler "Fehler beim Ausführen der Abfrage" ausgegeben wird, müssen Sie überprüfen, ob die Parameter wie in Schritt 11 beschrieben festgelegt wurden. Für die ListChildren-Methode sind die Parameter Item und Recursive erforderlich.

  16. Klicken Sie auf der Symbolleiste auf die Schaltfläche Felder aktualisieren (Aktualisieren der Datasetfelder). Hierdurch wird die Berichtsdefinition gespeichert und die Ansicht der Felder im Fenster Berichtsdataset aktualisiert, sodass nun alle Felder angezeigt werden, die Sie verwenden können.

    Das Dialogfeld sollte ungefähr der folgenden Abbildung entsprechen:

    Screenshot zu Datasetfeldern und Abfrageergebnissen

Nächste Schritte

Sie haben die Metadaten für ein Berichtsdataset für Berichtsserver-Datenbankelemente erfolgreich mithilfe des Berichtsserver-Webdienstes definiert. Wenn Sie den Bericht verarbeiten, werden die Daten, die durch die Dataset-Metadaten dargestellt werden, aus der Berichtsserver-Datenbank abgerufen. Anschließend können Sie aus einem Webdienst, der ein XML-System.Data.DataSet object zurückgibt, ein Berichtsdataset erstellen. Siehe Lektion 2: Definieren eines Berichtsdatasets für ein ADO.NET-DataSet aus einem Webdienst.

Siehe auch

Konzepte

Reporting Services-Lernprogramme

Andere Ressourcen

Definieren von Berichtsdatasets für XML-Daten
Herstellen einer Verbindung mit einer Datenquelle
Definieren von Berichtsdatasets
Vorgehensweise: Erstellen oder Bearbeiten einer berichtsspezifischen Datenquelle (Berichts-Designer)
Vorgehensweise: Erstellen eines Datasets (Berichts-Designer)
Arbeiten mit Feldern in einem Berichtsdataset
Vorgehensweise: Hinzufügen, Bearbeiten oder Löschen eines Feldes im Fenster Datasets (Berichts-Designer)
Berichtsdatasets (Berichts-Designer)

Hilfe und Informationen

Informationsquellen für SQL Server 2005