Freigeben über

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

  • Artikel

Gilt für: SQL Server 2016 (13.x) Reporting Services und höher

Mit dem Report Designer können Sie paginierte Berichte und Berichtslösungen in SQL Server Reporting Services (SSRS) mit vollem Funktionsumfang erstellen. Der Report Designer bietet Folgendes:

  • Eine Möglichkeit zum Definieren von Datenquellen, Datasets und Abfragen.
  • Funktionen zum Entwerfen und Anpassen des Layouts von Datenbereichen und Feldern.
  • Interaktive Features wie 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.

SSDT-Installation

SSDT ist nicht in SQL Server enthalten. Sie müssen SSDT separat installieren. Anweisungen finden Sie unter Installieren von SSDT mit Visual Studio.

Zum Verwenden von Report Designer-Vorlagen müssen Sie auch eine SSRS-Erweiterung für Visual Studio installieren. Anleitungen dafür finden Sie unter Installieren der Erweiterungen für Analysis Services, Integrationsdienste und Reporting Services.

Vorteile von Berichtsprojekten

In Report Designer können Sie Projekte zum Organisieren von Berichten verwenden. Berichtsprojekte dienen als Container für Berichtsdefinitionen und Ressourcen. Sie können Projekte für die folgenden Aufgaben verwenden:

  • Organisieren von Berichte und verwandten Elementen in einem Container.
  • Lokales Testen von Berichtslösungen mit Berichten und verwandten Elementen.
  • Gemeinsames Bereitstellen verwandter Elemente. Sie können die Projekteigenschaften und Konfigurationsverwaltung zum Bereitstellen von Elementen in mehreren Umgebungen nutzen.
  • Beibehalten einer Reihe primärer Kopien für Berichte und verwandte Elemente, da veröffentlichte Berichte nach der Bereitstellung versehentlich geändert werden können.

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

Freigegebene Datenquellen und Datasets

SSDT bietet eine Möglichkeit zum Definieren und Bereitstellen freigegebener Datenquellen und freigegebener Datasets für eine Berichtslösung.

  • Um eine freigegebene Datenquelle unabhängig von anderen Elementen in einem Projekt bereitzustellen, können Sie die Eigenschaften OverwriteDataSources und TargetDataSourceFolder verwenden.
  • Um ein freigegebenes Dataset unabhängig von anderen Elementen in einem Projekt bereitzustellen, können Sie die Eigenschaften OverwriteDatasets und TargetDatasetFolder verwenden.

Weitere Informationen finden Sie unter Festlegen von Bereitstellungseigenschaften (Reporting Services).

Im Report Designer nutzen Sie sowohl den Berichtsdatenbereich als auch den Projektmappen-Explorer, um die in einem Bericht verwendeten Datenquellen und freigegebenen Datasets zu definieren. Weitere Informationen finden Sie unter Berichtsdatenbereich.

Sie können eine Datenquellen, die auf einem Berichtsserver oder einer SharePoint-Website veröffentlicht, aber nicht in die SSDT-Projektmappe eingeschlossen wurde, nicht mit SSDT öffnen. Ebenso können Sie veröffentlichte Datasets mithilfe von SSDT nicht direkt von einem Berichtsserver oder einer SharePoint-Website aus öffnen. Zum Öffnen einer Datenquelle oder eines Datasets in diesen Szenarien können Sie den Report Builder verwenden. Weitere Informationen finden Sie unter Berichterstellungsumgebung des Berichts-Generators (SSRS). Verwenden Sie diese Umgebung für Datasets im Modus für freigegebene Datasets.

SSDT ist ein Clienttool. Sie können damit:

  • Testen Sie Ihre Berichtslösung lokal auf Ihrem Computer.
  • Testen Sie Ihre Serverlösung durch Bereitstellen Ihrer Berichtslösung in einer Testumgebung.
  • Stellen Sie Ihre Berichtslösung in einer Produktionsumgebung bereit.
  • Erleichtern Sie das lokale Erstellen und Testen Ihrer Abfrageergebnisse mit den Vorschaufunktionen des Abfrage-Designers.

Nach der Bereitstellung:

Weitere Informationen über die Aufnahme von Daten in paginierte Berichte finden Sie unter Erstellen von Datenverbindungszeichenfolgen in Report Builder.

Paginierte Berichte

Paginierte Berichte sind Dateien, die in einem Berichtsprojekt gespeichert werden. Sie können eine Datei mit einem paginierten Bericht als eigenständigen Bericht, als Unterbericht oder als Ziel für Drillthrough-Aktionen aus Hauptberichten verwenden. Um einen Bericht unabhängig von anderen Elementen in einem Projekt bereitzustellen, können Sie die Eigenschaft TargetReportFolder und andere Eigenschaften verwenden. Weitere Informationen finden Sie unter Festlegen von Bereitstellungseigenschaften (Reporting Services).

Hinweis

Beim Veröffentlichen auf einem Berichtsserver im SharePoint-Modus können Sie einige Berichtslösungsfunktionen im Report Designer-Projekt nicht testen. 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 Elementen auf einem Berichtsserver (SharePoint-Modus).

Wenn Sie die SSRS-Erweiterung in Visual Studio installieren, wie weiter oben unter SSDT-Installation erläutert, können Sie anhand der Report Server-Projektvorlage ein neues Projekt erstellen. Dann können Sie einen Bericht auf eine der folgenden Arten zu Ihrem Projekt hinzufügen:

  • Verwenden Sie den Berichts-Assistenten. 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 Berichts über den Berichts-Assistenten.

  • Fügen Sie ein neues Element vom Typ „Bericht“ hinzu. Ein leerer Bericht wird im Berichts-Designer geöffnet. Weitere Informationen finden Sie unter Hinzufügen eines neuen, leeren Berichts.

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

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

    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 einer RDL-Datei. Der Bericht wird im XML-Format als RDL-Datei gespeichert. Sie können diese Datei mit dem Report Designer, einem Texteditor oder einem beliebigen XML-Editor 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 (SSDT).

    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 Sie die in den Elementen verwendeten XML-spezifischen Zeichen richtig codieren. Wenn Sie den Bericht veröffentlichen, wird auf dem Berichtsserver der XML-Code in der RDL-Datei anhand des Schemas überprüft.

    Um Elemente einzuschließen, die nicht Teil des RDL-Schemas sind, fügen Sie sie in ein benutzerdefiniertes Element ein. Benutzerdefinierte Renderingerweiterungen können benutzerdefinierte Elemente lesen. Von den Renderingerweiterungen, die SSRS bereitstellt, wird das Element aber ignoriert. Sie können mithilfe des benutzerdefinierten Elements beispielsweise Kommentare in Ihrem 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).

Um Berichtsteile unabhängig von anderen Elementen in einem Projekt bereitzustellen, können Sie die Eigenschaft TargetReportPartFolder und andere Eigenschaften verwenden. 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. Bilder hinzufügen oder Shape-Dateien des Environmental Systems Research Institute, Inc. (ESRI) 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 des Report Designers auf die Designoberfläche, und ordnen Sie sie entsprechend an. Durch Ziehen von Datasetfeldern auf die Elemente in der Designoberfläche können Sie Daten zum Bericht hinzufü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 Report Builder und Report Designer einander ähnlich.

Anzeigen der Vorschau eines paginierten Berichts

Sie können anhand der Vorschau die Berichtsdaten und den Layoutentwurf überprüfen. Wenn Sie eine Vorschau eines Berichts anzeigen, überprüft der Berichtsprozessor das Berichtsdefinitionsschema und die Ausdruckssyntax. Außerdem werden Probleme im Fenster Ausgabe 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 <report-name>.rdl.data in demselben Verzeichnis wie die Berichtsdefinitionsdatei gespeichert. Die Datei wird nicht gelöscht, wenn Sie den Report Designer schließen.

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

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

  • Eigenständige Vorschau. Sie können den lokalen Bericht in einem Browser ausführen. 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:

    • Im Menü Debuggen können Sie Debuggen starten auswählen.
    • Auf der Visual Studio-Standardsymbolleiste können Sie die Schaltfläche Start auswählen.
    • Sie können F5 auswählen.

    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

    Für den Debugmodus müssen Sie ein Startelement festlegen. Gehen Sie zum Festlegen eines Startelements zum Projektmappen-Explorer, klicken Sie mit der rechten Maustaste auf das Berichtsprojekt und wählen Sie Eigenschaften aus. Wählen Sie dann unter StartItem den Namen des anzuzeigenden Berichts aus.

    Wenn Sie eine Vorschau eines bestimmten Berichts anzeigen möchten, der nicht das Startelement für das Projekt ist, können Sie eine Konfiguration auswählen, die den Bericht erstellt, aber nicht bereitstellt. Sie können beispielsweise die DebugLocal-Konfiguration verwenden. Klicken Sie dann mit der rechten Maustaste auf den Bericht und wählen Sie Ausführen aus. Sie müssen eine Konfiguration auswählen, die den Bericht nicht bereitstellt. Andernfalls wird der Bericht auf dem Berichtsserver veröffentlicht, statt lokal in einem Vorschaufenster angezeigt zu werden.

  • Druckvorschau. Wenn Sie einen Bericht zum ersten Mal im Vorschaumodus oder im Vorschaufenster anzeigen, gleicht die Anzeige des Berichts einem Bericht, der von einer HTML-Renderingerweiterung erzeugt wird. 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. Wenn Sie auf der Symbolleiste Druckvorschau auswählen, wird der Bericht so wie auf einer physischen Seite angezeigt. Diese Ansicht gleicht der Ausgabe durch die Bild- und PDF-Renderingerweiterungen. Die Druckvorschau ist keine Bild- oder PDF-Datei, das Layout und die Paginierung des Berichts gleichen jedoch der Ausgabe in diesen Formaten. Sie können z. B. die Größe des Berichtsbilds auswählen und die Breite der Seite festlegen.

    Die Druckvorschau hilft Ihnen, 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 an Berichtslayouts für ein besseres Erscheinungsbild 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.

Im Report Designer entwerfen Sie einen Bericht unter Verwendung des Berichtsdefinitionsschemas, das von der aktuellen Version von SSRS in 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 früheren Version von SSRS 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 der Report Designer bereitstellt, befindet sich im Buildordner.

Hinweis

Zum Debuggen von Ausdrücken und Bereitstellungsfehlern müssen Sie die Berichtsdefinition im Buildordner anzeigen. Verwenden Sie in diesem Fall nicht Code anzeigen aus dem Kontextmenü der Berichtsdatei zum Anzeigen der Berichtsdefinition. Wenn Sie Code anzeigen auswählen, öffnen Sie die Berichtsdefinitionsquelle aus dem Projektordner.

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

Lokales Speichern eines Berichts

Wenn Sie Berichte oder andere Projektelemente im Report Designer bearbeiten, werden die Dateien auf dem lokalen Computer oder in einer Dateifreigabe auf einem anderen Computer gespeichert, auf den Sie Zugriff haben.

Wenn Sie Software für die Quellcodeverwaltung verwenden, wird ein Bericht durch das Speichern möglicherweise in den Quellcodeverwaltungsserver eingecheckt. Weitere Informationen finden Sie unter Quellcodeverwaltung.

Bereitstellen oder Veröffentlichen von paginierten Berichten

Über SSDT können Sie Berichte oder andere Projektelemente in mehreren Versionen von SSRS-Berichtsservern bereitstellen. Das Upgrade von Berichtsdefinitionen auf Schemaversionen, die mit den Zielberichtsservern kompatibel sind, steuern Sie mithilfe von Projektkonfigurationen. Projektkonfigurationen steuern bestimmte Eigenschaften wie den Zielberichtsserver, den 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 Probleme auftreten. Berichte können z. B. Zeichenfolgen, wie Ausdrücke oder Abfragen, enthalten, die mit der von der Projektkonfiguration angegebenen Version von SSRS nicht kompatibel sind.

Verwenden Sie die ErrorLevel-Eigenschaft, um die während der Erstellung angezeigten Warnungen und Fehler zu verwalten. Sie können der ErrorLevel-Eigenschaft einen Wert von 0 bis einschließlich 4 zuweisen. 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 SSDT-Ausgabefenster geschrieben.

Probleme, deren Schweregrad kleiner oder gleich dem ErrorLevel-Wert ist, werden als Fehler gemeldet. Andere Probleme werden als Warnungen gemeldet.

In der folgenden Tabelle sind die Fehlerebenen aufgeführt.

Fehlerebene BESCHREIBUNG
0 Äußerst schwerwiegende Erstellungsprobleme, die die Vorschau und Bereitstellung von Berichten verhindern
1 Schwerwiegende Erstellungsprobleme, die das Berichtslayout drastisch ändern
2 Weniger schwerwiegende Erstellungsprobleme, die das Berichtslayout wesentlich ändern
3 Kleinere Erstellungsprobleme, die das Berichtslayout auf geringfügigere Weise ändern, die möglicherweise nicht auffällt
4 Warnungen zu Veröffentlichungsproblemen

Sie können versuchen, einen Bericht als Vorschau anzuzeigen oder bereitzustellen, der Berichtselemente enthält, die in Ihrer Version von SSRS nicht unterstützt werden. Diese Berichtselemente werden jedoch manchmal aus dem Bericht entfernt, und es wird ein Fehler der Ebene 2 ausgegeben. Wenn Ihre ErrorLevel-Eigenschaft auf den Standardwert 2 festgelegt ist, tritt beim Erstellen in diesem Fall ein Fehler auf.

Sie können dieses Problem umgehen, indem Sie den ErrorLevel-Wert auf 0 oder 1 ändern. Wenn das Element gelöscht wird, wird eine Warnung ausgegeben, und der Erstellungsvorgang wird fortgesetzt.

Zugehöriger Inhalt