Erstellen von paginierten Berichten von Reporting Services mit dem Report Designer (SSRS)

Mit dem Berichts-Designer können Sie paginierte Reporting Services -Berichte und -Berichtslösungen mit vollem Funktionsumfang erstellen. Report Designer stellt eine grafische Oberfläche bereit, in der Sie Datenquellen definieren können. Sie verfügt auch über Datasets und Abfragen, Berichtslayoutpositionen für Datenbereiche und Felder sowie interaktive Funktionen. z. B. Parameter und zusammenwirkende Berichtssätze.

Der Berichts-Designer ist ein Feature von SQL Server Data Tools (SSDT), einer Microsoft Visual Studio-Umgebung zum Erstellen von Business Intelligence-Lösungen. SQL Server Data Tools (SSDT) ist nicht im Lieferumfang von SQL Server enthalten. Herunterladen von SQL Server Data Tools.

Vorteile von Berichtsprojekten

Berichtsprojekte dienen als Container für Berichtsdefinitionen und Ressourcen. Verwenden Sie Projekte für folgende Aufgaben:

  • Organisieren Sie Berichte und verwandten Elemente in einem Container.

  • Testen Sie Berichtslösungen mit Berichten und verwandten Elementen lokal.

  • Stellen Sie verwandte Elemente gemeinsam bereit. Nutzen Sie die Projekteigenschaften und Konfigurationsverwaltung für eine Bereitstellung in mehreren Umgebungen.

  • Behalten Sie einen Satz von primären Kopien für Berichte und verwandte Elemente bei. Nach der Bereitstellung können veröffentlichte Berichte unbeabsichtigt geändert werden.

Anhand der Informationen in diesem Artikel können Sie paginierte Berichte und verwandte Elemente für ein konkretes Berichtsprojekt in einer SQL Server Data Tools (SSDT) -Projektmappe entwerfen. Weitere Informationen zu Projektmappen und mehreren Projekten in SQL Server Data Tools finden Sie unter Reporting Services in SQL Server Data Tools.

Freigegebene Datenquellen

Verwenden Sie SQL Server Data Tools , um freigegebene Datenquellen für eine Berichtslösung zu definieren und bereitzustellen. Freigegebene Datenquellen können mit den Eigenschaften OverwriteDataSources und TargetDataSourceFolder unabhängig von anderen Elementen in einem Projekt bereitgestellt werden. Weitere Informationen finden Sie unter Festlegen von Bereitstellungseigenschaften (Reporting Services).

Im Berichts-Designer nutzen Sie sowohl den Berichtsdatenbereich als auch den Projektmappen-Explorer, um die in einem Bericht verwendeten Datenquellen zu definieren. Weitere Informationen finden Sie unter Report Data Pane. Sie können Datenquellen, die auf einem Berichtsserver oder einer SharePoint-Website veröffentlicht, aber nicht in die SQL Server Data Tools-Projektmappe eingeschlossen wurden, nicht mit SQL Server Data Tools öffnen. Verwenden Sie für diese Funktion die Berichterstellungsumgebung des Berichts-Generators (SSRS).

SQL Server Data Tools ist ein Clienttool. Sie können die Berichtslösung lokal auf dem Computer testen, zum Testen der Serverlösung in einer Testumgebung bereitstellen und dann in einer Produktionsumgebung bereitstellen. Überprüfen Sie nach der Bereitstellung, dass die Verarbeitungserweiterungen und Anmeldeinformationen der Datenquelle für die Berichtsserverumgebung konfiguriert wurden. Der Konfigurations-Manager unterstützt Sie beim Verwalten der Eigenschaften für verschiedene Bereitstellungen. Weitere Informationen finden Sie unter Reporting Services in SQL Server-Datentools (SSDT).

Weitere Informationen finden Sie unter Erstellen von Datenverbindungszeichenfolgen (Berichts-Generator und SSRS).

Freigegebene Datasets

Verwenden Sie SQL Server Data Tools , um freigegebene Datasets für eine Berichtslösung zu definieren und bereitzustellen. Freigegebene Datasets können mit den Eigenschaften OverwriteDatasets und TargetDatasetFolder unabhängig von anderen Elementen in einem Projekt bereitgestellt werden. Weitere Informationen finden Sie unter Festlegen von Bereitstellungseigenschaften (Reporting Services).

Im Berichts-Designer nutzen Sie sowohl den Berichtsdatenbereich als auch den Projektmappen-Explorer, um die in einem Bericht verwendeten freigegebenen Datasets zu definieren. Weitere Informationen finden Sie unter Report Data Pane. Sie können veröffentlichte Datasets mithilfe von SQL Server Data Tools nicht direkt von einem Berichtsserver oder einer SharePoint-Website aus öffnen. Verwenden Sie für diese Funktion die Berichterstellungsumgebung des Berichts-Generators (SSRS) im Modus für freigegebene Datasets.

SQL Server Data Tools ist ein Clienttool. Abfrage-Designern unterstützen Sie beim Erstellen und Testen von Abfrageergebnissen lokale in der Vorschau. Nach der Bereitstellung können Sie freigegebene Datasets unabhängig von den freigegebenen Datenquellen und Berichten verwalten, von denen sie abhängen. Weitere Informationen finden Sie unter Erstellen von Berichten zu eingebetteten und freigegebenen Datasets (Berichts-Generator und SSRS), Abfrageentwurfstools (SSRS) und Verwalten von freigegebenen Datasets.

Paginierte Berichte

Paginierte Berichte sind Dateien, die in einem Berichtsprojekt gespeichert werden. Berichte können als eigenständige Berichte, als Unterberichte oder als Ziele für Drillthroughaktionen in Hauptberichten verwendet werden. Mit TargetReportFolder und anderen Eigenschaften können Berichte unabhängig von anderen Elementen in einem Projekt bereitgestellt werden. Weitere Informationen finden Sie unter Festlegen von Bereitstellungseigenschaften (Reporting Services).

Hinweis

Bei Veröffentlichung auf einem Berichtsserver im SharePoint-Modus können einige Berichtslösungsfunktionen im Berichts-Designer-Projekt nicht getestet werden. Für Verweise auf Berichte, Unterberichte und Drillthroughberichte müssen vollqualifizierte URLs verwendet werden, die erst nach der Bereitstellung des Berichtsprojekts getestet werden können. Weitere Informationen finden Sie unter Beispiele für URLs von veröffentlichten Berichtselementen auf einem Berichtsserver im SharePoint-Modus (SSRS).

Sie können einem Projekt Berichte auf folgende Weise hinzufügen:

  • Fügen Sie ein neues Berichtsprojekt hinzu. Standardmäßig wird ein leerer Bericht in Berichts-Designer geöffnet. Weitere Informationen finden Sie unter Hinzufügen eines neuen oder vorhandenen Berichts zu einem Berichtsprojekt (SSRS).

  • Fügen Sie ein Berichts-Assistent-Projekt hinzu. Sie erstellen das Projekt mithilfe einer detaillierten Anleitung. Der Berichts-Assistent vereinfacht die Datendefinition und den Berichtsentwurf, indem er sie in einzelne Schritte aufteilt und am Ende einen fertigen Bericht erstellt. Sie können Formate hinzufügen und den Assistenten so für Ihre Organisation anpassen. Weitere Informationen finden Sie unter Hinzufügen eines neuen oder vorhandenen Berichts zu einem Berichtsprojekt (SSRS).

  • Fügen Sie ein neues Element vom Typ "Bericht" hinzu. Ein leerer Bericht wird im Berichts-Designer geöffnet.

  • Fügen Sie ein vorhandenes Element hinzu. Eine vorhandene Berichtsdefinition (.rdl) wird im Berichts-Designer geöffnet. Beim Öffnen eines Berichts oder Projekts aus einer früheren Version von Reporting Services wird das Projekt ggf. automatisch auf die aktuelle Version bzw. der Bericht auf das aktuelle Schema aktualisiert. Weitere Informationen finden Sie unter Upgrade Reports.

  • Importieren Sie einen Microsoft-Zugriffsbericht. Importieren Sie alle Berichte aus einer Access-Datenbank (.mdb, .accdb) oder einer Projektdatei (.adp). Jeder Bericht in einer Datenbank- oder Projektdatei wird vom Berichts-Designer in Berichtsdefinitionssprache (RDL, Report Definition Language) konvertiert und im Berichtsprojekt gespeichert. Nicht alle Funktionen eines Access-Berichts werden in eine Berichtsdefinitionsdatei (.rdl) übertragen. Weitere Informationen finden Sie unter Importieren von Berichten aus Microsoft Access (Reporting Services) und Unterstützte Zugriffsberichtsfunktionen (SSRS).

    Hinweis

    Die Verwendung des Importfunktionen setzt voraus, dass auf dem Computer, auf dem auch der Berichts-Designer installiert ist, Access 2002 oder höher installiert ist. Beim Importieren der Berichte muss die Datenquelle für die Access-Berichte verfügbar sein.

  • Arbeiten Sie direkt in RDL. Wenn Sie im Berichts-Designer einen Bericht erstellen, wird dieser als RDL-Datei (Report Definition Language, Berichtsdefinitionssprache) im XML-Format gespeichert. Sie können diese Datei mit dem Berichts-Designer, einem Texteditor oder jedem anderen Tool zur Bearbeitung von XML bearbeiten.

    Wenn Sie die Berichtsdefinitionsquelle im Report Designer ändern, bearbeiten Sie das aktuelle RDL-Schema für die Version von SQL Server, von der aus Sie die Entwicklungstools installiert haben. Wenn Sie ein Projekt erstellen, kann sich die Schemaversion abhängig von den Bereitstellungseigenschaften ändern. Weitere Informationen finden Sie unter Bereitstellung und Versionsunterstützung in SQL Server Data Tools (SSRS).

    Das direkte Bearbeiten von RDL kann zur Folge haben, dass der Bericht nicht auf dem Berichtsserver veröffentlicht oder nicht ausgeführt werden kann. Stellen Sie wie bei jeder XML-Datei sicher, dass in den Elementen verwendete XML-spezifische Zeichen richtig codiert sind. Wenn Sie den Bericht veröffentlichen, wird auf dem Berichtsserver der in der RDL-Datei enthaltene XML-Code anhand des Schemas überprüft.

    Um Elemente einzuschließen, die nicht Teil des RDL-Schemas sind, fügen Sie sie in das Custom-Element ein. Benutzerdefinierte Renderingerweiterungen können das Custom-Element lesen. Aber die Renderingerweiterungen, die Reporting Services bereitstellt, ignorieren das Element. Sie können mithilfe des Custom-Elements beispielsweise Kommentare im Bericht speichern.

    Weitere Informationen finden Sie unter Berichtsdefinitionssprache (SSRS).

Berichtsteile

Hinweis

Berichtsteile sind für alle Releases von SQL Server Reporting Services ab SQL Server Reporting Services 2019 und für alle Releases von Power BI-Berichtsserver ab Power BI-Berichtsserver September 2022 veraltet.

In Report Designer können Sie Tabellen, Diagramme und andere paginierte Berichtselemente in einem Projekt erstellen. Nach dem Erstellen können Sie sie als Berichtsteile auf einem Berichtsserver oder auf einer in einen Berichtsserver integrierten SharePoint-Website veröffentlichen. Dadurch können Sie und andere Personen sie in anderen Berichten wiederverwenden. Weitere Informationen finden Sie unter Berichtsteile im Berichts-Designer (SSRS).

Mit TargetReportPartFolder und anderen Eigenschaften können Berichtsteile unabhängig von anderen Elementen in einem Projekt bereitgestellt werden. Weitere Informationen finden Sie unter Festlegen von Bereitstellungseigenschaften (Reporting Services).

Ressourcen

Sie können dem Projekt Dateien hinzufügen, die zwar einen Bezug zu dem Bericht haben, aber nicht vom Berichtsserver verarbeitet werden. Sie können z. B. Grafiken für Bilder oder ESRI-Shape-Dateien für räumliche Daten hinzufügen. Weitere Informationen finden Sie unter Ressourcen.

Paginiertes Berichtslayout

Um das Berichtslayout zu erstellen, ziehen Sie Berichtselemente und Datenbereiche aus der Toolbox auf die Entwurfsoberfläche, und ordnen Sie sie entsprechend an. Ziehen Sie Datasetfelder auf die Elemente in der Entwurfsoberfläche, um dem Bericht Daten hinzuzufügen. Wenn Sie Daten in einem Tablix-Datenbereich in Gruppen organisieren möchten, ziehen Sie Datasetfelder in den Bereich für die Gruppierung. Da Berichterstellungstools primär zum Erstellen von Berichtsdefinitionen dienen, sind die Ansätze für den Berichtsentwurf im Berichts-Generator und Report Designer einander ähnlich.

Anzeigen der Vorschau eines paginierten Berichts

Verwenden Sie die Vorschau , um die Berichtsdaten und den Layoutentwurf zu überprüfen. Wenn Sie eine Vorschau eines Berichts anzeigen, überprüft der Berichtsprozessor das Berichtsdefinitionsschema und die Ausdruckssyntax. Probleme werden im Fenster Output aufgelistet.

Hinweis

Wenn Sie eine Vorschau für einen Bericht anzeigen, werden die Daten für den Bericht auf dem lokalen Computer in einer Datei zwischengespeichert. Wenn Sie für denselben Bericht erneut eine Vorschau anzeigen, indem Sie dieselbe Abfrage und dieselben Parameter und Anmeldeinformationen verwenden, ruft der Report Designer die zwischengespeicherte Kopie ab, anstatt die Abfrage erneut auszuführen. Die Datendatei wird unter <reportname>.rdl.data in demselben Verzeichnis wie die Berichtsdefinitionsdatei gespeichert. Die Datei wird nicht gelöscht, wenn Sie den Berichts-Designer schließen.

Sie können eine Vorschau eines Berichts wie folgt anzeigen:

  • Vorschauansicht. Wählen Sie auf die Registerkarte Vorschau aus. Der Bericht wird lokal mit derselben Berichtsverarbeitungs- und Renderingfunktionalität ausgeführt, die auf dem Berichtsserver zur Verfügung steht. Der Bericht wird als interaktives Bild angezeigt, in dem Sie Parameter auswählen, Links auswählen, die Dokumentstruktur anzeigen und ausgeblendete Bereiche des Berichts erweitern bzw. reduzieren können. Darüber hinaus können Sie den Bericht in jedes installierte Renderingformat exportieren.

  • Eigenständige Vorschau. Führen Sie den lokalen Bericht in einem Browser aus. Mit einer Debugkonfiguration können Sie diesen Modus auch verwenden, um von Ihnen geschriebene benutzerdefinierte Assemblys zu debuggen. Es gibt drei Möglichkeiten, ein Projekt im Debugmodus auszuführen:

    • Wählen Sie im Menü Debuggen die Option Debuggen starten aus.

    • Wählen Sie auf der Visual Studio -Standardsymbolleiste die Schaltfläche Start aus.

    • Drücken Sie F5.

    Falls Sie eine Projektkonfiguration verwenden, die zwar den Bericht erstellt, aber nicht bereitstellt, wird der in der StartItem-Eigenschaft angegebene Bericht der aktuellen Konfiguration in einem separaten Vorschaufenster geöffnet.

    Hinweis

    Um den Debugmodus verwenden zu können, müssen Sie ein Startelement festlegen. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Berichtsprojekt, klicken Sie auf Eigenschaften, und wählen Sie unter StartItemden Namen des anzuzeigenden Berichts aus.

    Wenn Sie einen bestimmten Bericht in der Vorschau anzeigen möchten, der nicht als Startelement für das Projekt festgelegt ist, wählen Sie eine Konfiguration aus, die den Bericht zwar erstellt, jedoch nicht bereitstellt (z. B. die DebugLocal-Konfiguration). Klicken Sie dann mit der rechten Maustaste auf den Bericht, und wählen Sie anschließend Ausführen aus. Sie müssen eine Konfiguration auswählen, die den Bericht nicht bereitstellt. Andernfalls wird der Bericht nicht auf dem Berichtsserver veröffentlicht, sondern lokal in einem Vorschaufenster angezeigt.

  • Seitenansicht.

    Wenn Sie einen Bericht zum ersten Mal im Vorschaumodus oder im Vorschaufenster anzeigen, gleicht die Anzeige des Berichts einem per HTML-Renderingerweiterung erstellten Bericht. Die Vorschau ist kein HTML-Code, das Layout und die Paginierung des Berichts gleichen jedoch der HTML-Ausgabe.

    Sie können die Ansicht ändern und einen gedruckten Bericht darstellen, indem Sie zur Seitenansicht wechseln. Wählen Sie auf der Vorschausymbolleiste die Schaltfläche Seitenansicht aus. Der Bericht wird so angezeigt, wie er auf einer physischen Seite dargestellt werde würde. Diese Ansicht gleicht der Ausgabe durch die Bild- und PDF-Renderingerweiterung. Die Seitenansicht ist keine Bild- oder PDF-Datei, das Layout und die Paginierung des Berichts gleichen jedoch der Ausgabe in diesen Formaten. Sie können die Größe des Berichtsbilds auswählen, z. B. indem Sie die Breite der Seite festlegen.

    Die Seitenansicht hilft Ihnen, zahlreiche Renderingprobleme zu erkennen, die beim Drucken des Berichts auftreten können. Folgende Renderingprobleme können auftreten:

    • Zusätzliche leere Seiten, da der Bericht zu breit für das Papierformat ist, das für den Bericht angegeben wurde.

    • Zusätzliche leere Seiten, da der Bericht eine Matrix enthält, die dynamisch erweitert wird, um die angegebene Breite des Papiers zu überschreiten.

    • Unerwünschte Seitenumbrüche zwischen Gruppen.

    • Falsche Anzeige von Kopf- und Fußzeilen.

    • Notwendige Änderungen am Berichtslayout für eine bessere Lesbarkeit im gedruckten Format.

Speichern und Bereitstellen von paginierten Berichten

Sie können Berichte und andere Projektdateien im Berichts-Designer lokal speichern oder auf einem Berichtsserver oder einer SharePoint-Website bereitstellen. Freigegebene Datenquellen, freigegebene Datasets, Berichte, Berichtsressourcen und Berichtsteile können abhängig von den konfigurierten Projektbereitstellungseigenschaften unabhängig oder zusammen bereitgestellt werden. Weitere Informationen finden Sie unter Konfigurations- und Bereitstellungseigenschaften.

Beachten Sie, dass Sie Berichte im Report Designer unter Verwendung des Berichtsdefinitionsschemas entwerfen, das von der aktuellen Version von Reporting Services in SQL Server Data Tools (SSDT) unterstützt wird. Sie können Projektbereitstellungseigenschaften für einen bestimmten Berichtsserver oder eine SharePoint-Website festlegen. Wenn Sie den Bericht speichern, speichert der Report Designer die Berichtsdefinition im Buildverzeichnis in dem Schema, das der Version auf dem Zielberichtsserver entspricht. Um Berichte zu erstellen, die auf einem Berichtsserver einer niedrigeren Version veröffentlicht werden können, löscht der Report Designer Berichtselemente, die im Zielschema nicht vorhanden sind. Dies erfolgt automatisch und ohne Aufforderung. In diesem Fall wird die ursprüngliche Berichtsdefinition im Projektordner beibehalten. Die geänderte Berichtsdefinition, die bereitgestellt wird, befindet sich im Buildordner.

Hinweis

Zum Debuggen von Ausdrücken und Bereitstellungsfehlern müssen Sie die Berichtsdefinition im Buildordner anzeigen. Verwenden Sie nicht Quelltext anzeigen. DurchQuelltext anzeigen wird die Berichtsdefinitionsquelle aus dem Projektordner angezeigt.

Weitere Informationen finden Sie unter Bereitstellung und Versionsunterstützung in SQL Server Data Tools (SSRS).

Lokales Speichern eines Berichts

Wenn Sie einen Bericht oder andere Projektelemente im Berichts-Designer bearbeiten, werden die Dateien auf dem lokalen Computer oder einer Freigabe auf einem anderen Computer gespeichert, auf den Sie Zugriff haben.

Wenn Sie Software für die Quellcodeverwaltung verwenden, müssen Sie die Berichte beim Speichern möglicherweise in den Quellcodeverwaltungsserver einchecken. Weitere Informationen finden Sie unter Quellcodeverwaltung.

Bereitstellen oder Veröffentlichen von paginierten Berichten

Ab SQL Server Data Toolskönnen Sie Berichte oder andere Projektelemente in mehreren Versionen von Reporting Services -Berichtsservern bereitstellen. Das Upgrade von Berichtsdefinitionen auf Schemaversionen, die mit den Zielberichtsservern kompatibel sind, steuern Sie mithilfe von Projektkonfigurationen. Zu den mittels Projektkonfigurationen gesteuerten Eigenschaften zählen der Zielberichtsserver, der Ordner, in dem der Buildprozess vorübergehend Berichtsdefinitionen für die Vorschau und Bereitstellung speichert, und die Fehlerebenen. Weitere Informationen finden Sie unter Konfigurations- und Bereitstellungseigenschaften und Festlegen von Bereitstellungseigenschaften (Reporting Services).

Exportieren eines paginierten Berichts in ein anderes Dateiformat

Berichte können in verschiedene Formate exportiert werden. Diese Formate haben Einfluss auf die Funktionsweise einiger Berichtslayouts und interaktiver Funktionen. Weitere Informationen zu Entwurfsüberlegungen für verschiedene Ausgabeformate finden Sie unter Exportieren paginierter Berichte (Berichts-Generator und SSRS).

Berichtsüberprüfung und Fehlerebenen

Berichte werden vor der Vorschau und während der Bereitstellung überprüft. Beim Erstellen von Berichten können viele Erstellungsprobleme auftreten. Berichte können Zeichenfolgen, z. B. Ausdrücke oder Abfragen, enthalten, die mit der von der Projektkonfiguration angegebenen Version von Reporting Services nicht kompatibel sind.

Verwenden Sie die ErrorLevel-Eigenschaft, um die während der Erstellung angezeigten Warnungen und Fehler zu verwalten. Die ErrorLevel-Eigenschaft kann einen Wert von 0 bis einschließlich 4 enthalten. Durch den Wert wird bestimmt, welche Erstellungsprobleme als Fehler und welche als Warnungen gemeldet werden. Der Standardwert ist 2. Die Warnungen und die Fehler werden in das SQL Server Data Tools (SSDT)-Ausgabefenster geschrieben.

Probleme mit Schweregraden kleiner oder gleich dem Wert von ErrorLevel werden als Fehler gemeldet. Andernfalls werden die Probleme als Warnungen gemeldet.

In der folgenden Tabelle sind die Fehlerebenen aufgeführt.

Fehlerebene BESCHREIBUNG
0 Äußerst schwerwiegende und unvermeidliche Erstellungsprobleme, die die Vorschau und Bereitstellung von Berichten verhindern.
1 Schwere Erstellungsprobleme, die das Berichtslayout drastisch ändern.
2 Weniger schwere Erstellungsprobleme, die das Berichtslayout wesentlich ändern.
3 Kleinere Erstellungsprobleme, die das Berichtslayout auf geringfügigere Weise ändern, die möglicherweise nicht auffällt.
4 Wird nur für Veröffentlichungswarnungen verwendet.

Wenn Sie einen Bericht, der neue Berichtselemente in SQL Server 2016 (13.x) Reporting Services oder höher (SSRS) enthält, in der Vorschau anzeigen oder bereitstellen, können diese Berichtselemente aus dem Bericht entfernt werden. Standardmäßig wird die ErrorLevel-Eigenschaft der Konfiguration auf 2 festgelegt. Dies würde dazu führen, dass der Bericht nicht erstellt wird, sobald die Struktur entfernt wurde. Wenn Sie den Wert der ErrorLevel-Eigenschaft in 0 oder 1 ändern, wird die Struktur jedoch gelöscht, eine Warnung ausgegeben und der Erstellungsvorgang fortgesetzt.

Herunterladen von SQL Server Data Tools
Reporting Services in SQL Server Data Tools
Abfrageentwurfstools
Bereitstellung und Versionsunterstützung in SQL Server Data Tools

Haben Sie dazu Fragen? Stellen Sie eine Frage im Reporting Services-Forum