Rendern in das HTML-Format (Berichts-Generator)

  • Artikel

Die HTML-Renderingerweiterung rendert einen paginierten Bericht im HTML-Format. Die Renderingerweiterung kann außerdem vollständige HTML-Seiten oder HTML-Fragmente zum Einbetten in andere HTML-Seiten erstellen. HTML wird stets mit UTF-8-Codierung erstellt.

Die HTML-Renderingerweiterung ist die Standarderweiterung zum Rendern von Berichten, die in einem Browser angezeigt werden, auch dann, wenn sie im Webportal von SQL Server 2016 (13.x) Reporting Services (SSRS) oder höher ausgeführt werden. Die HTML-Renderingerweiterung kann HTML als Fragment oder als vollständiges HTML-Dokument rendern. Falls HTML ein Fragment ist, werden die Tags HEAD, HTMLund BODY des HTML-Dokuments entfernt. Nur der Inhalt des BODY -Tags wird gerendert. Dieses Ergebnis ist hilfreich beim Einbetten des HTML-Codes in den von einer anderen Anwendung erstellten HTML-Code.

In einigen Szenarien können mit Berichtsparametern Script-Injection-Angriffe gestartet werden, wenn Berichte in HTML gerendert werden. Weitere Informationen zum Schützen von Berichten finden Sie unter Sichere Berichte und Ressourcen.

Weitere Informationen zu Browsern finden Sie unter Browserunterstützung für Reporting Services.

Hinweis

Sie können paginierte Berichtsdefinitionsdateien (.rdl) im Berichts-Generator von Microsoft, im Power BI Report Builder und im Berichts-Designer in SQL Server-Datentools erstellen und ändern.

Rendern in MHTML

Die HTML-Renderingerweiterung kann Berichte im MHTML-Format (MIME Encapsulation of Aggregate HTML Documents) rendern. MHTML erweitert HTML, um codierte Objekte in das HTML-Dokument einzubetten, z. B. Bilder. Mit der MHTML-Renderingerweiterung können Sie Ressourcen wie Bilder, Dokumente oder andere Binärdateien als MIME-Strukturen (Multipurpose Internet Mail Extensions) in den Berichts-HTML-Code in einer einzelnen Datei einbetten. Daneben sind MHTML-Berichte zur Einbettung in E-Mail-Nachrichten geeignet, da alle Ressourcen in den Bericht eingeschlossen sind. Zwar rendert eigentlich die HTML-Renderingerweiterung MHTML, aber diese Funktion kann auch als MHTML-Renderingerweiterung bezeichnet werden.

Browserunterstützung

Diese Renderingerweiterung unterstützt die folgenden Browserversionen:

  • Internet Explorer 5.5 und höher

  • Firefox 1.5 und höher

  • Safari 3.0 und höher

Aufgrund von browserübergreifenden Überlegungen kann der gerenderte Bericht je nach Browser leicht unterschiedlich ausfallen. So enthält z. B. das Textfeld die Eigenschaft „WritingMode“. Diese Eigenschaft wird in Firefox nicht unterstützt.

HTML-spezifische Renderingregeln

Die folgenden HTML-spezifischen Regeln werden beim Rendern angewendet:

  • Der Renderer erstellt eine HTML-Tabellenstruktur mit allen Elementen in jeder ReportItems-Sammlung, falls mehr als eine vorhanden ist.

  • Jedes Element innerhalb der Tabellenstruktur nimmt eine einzelne Zelle ein.

  • Leere Zellen werden so weit wie möglich reduziert, um die Größe der HTML-Datei zu reduzieren.

  • Eine Reihe leerer Zellen wird dem oberen Rand und eine weitere Spalte dem linken Rand hinzugefügt, um die Geschwindigkeit, mit der Browser die Tabelle rendern können, zu erhöhen.

  • Tabellenzeilen oder -spalten, die keine Elemente, sondern nur Lücken zwischen Elementen enthalten, erhalten eine feste Breite und Höhe.

  • Allen anderen Zeilen und Spalten können abhängig von der Größe der einzelnen Berichtselemente zunehmen.

  • Alle Koordinaten und Berichtselementgrößen werden in Millimeter konvertiert. Alle anderen Größen, einschließlich der Stileigenschaften, behalten ihre ursprünglichen Einheiten bei. Größen- und Positionsunterschiede unter 0,2 mm werden als 0 mm behandelt.

Interaktivität

Einige interaktive Elemente werden in HTML unterstützt. Im folgenden Abschnitt werden spezifische Funktionsweisen beschrieben.

Einblenden und Ausblenden

Ein Berichtselement, das ein- und ausgeblendet werden kann, wird mit einem Bild zum Umschalten (+/-) gerendert. Dieses Element kann ausgewählt werden. Wenn das Element ausgewählt wird, erfolgt ein Rückruf an den Server, um die Ausgabe mit dem geänderten aktuellen Ansichtsstatus erneut zu rendern.

Dokumentstruktur

Dokumentstrukturbezeichnungen werden gerendert und sind navigierbar. Verwenden Sie dazu die Dokumentstruktur im Steuerelement für den Viewer. Für ausgelassene Datenbereichskopfzeilen werden Bezeichnungen auf der ersten untergeordneten Zelle gerendert. Wenn keine untergeordnete Zelle vorhanden ist, wird die Bezeichnung auf dem untergeordneten Element gerendert, das ihm vorausgeht.

Lesezeichen

Lesezeichenlinks werden gerendert und als Links angezeigt. Lesezeichenziele werden gerendert. Die Navigation zu diesen Zielen erfolgt durch Auswählen der Lesezeichenlinks. Wenn ein Lesezeichenlink ausgewählt ist, wechselt der Bericht zum ersten Vorkommen der Zielmarkenbezeichnung. Wenn möglich, wird der Browser gescrollt, sodass sich der Lesezeichenlink am oberen Rand des Fensters befindet. Zum Markieren von Lesezeichenzielen werden HTML-Anchortags (<a>) verwendet.

Interaktive Sortierung

Bei einem Textfeld mit benutzerdefinierter Sortierung rendert die HTML-Renderingerweiterung die Sortiersymbole im Textfeld rechts vom Inhalt. Wenn ein Bericht ein Textfeld enthält, in dem die Benutzersortierung definiert ist, wird JavaScript gerendert. Das JavaScript bewirkt, dass ein Postback auf dem Server erfolgt, wenn das Sortierbild ausgewählt ist.

Hyperlinks und Drillthroughlinks werden in Berichtselementen als Hyperlinks gerendert. Dabei wird das HTML-Anchortag (<a>) um das Element verwendet, für das sie definiert sind.

Die Suchfunktion ermöglicht es Benutzern, nach einer Textzeichenfolge innerhalb des Berichts zu suchen.

Weitere Suchfunktionen werden vom ReportViewer Web Forms-Steuerelement bereitgestellt.

Schriftarten auf dem Clientcomputer

Wenn eine benutzerdefinierte Schriftart in dem Bericht verwendet wird, muss diese auf dem Computer installiert sein, der zum Anzeigen des Berichts verwendet wird (dem Clientcomputer), damit der Bericht fehlerfrei angezeigt wird. Wenn die Schriftart auf dem Clientcomputer nicht installiert ist, wird der Bericht in einer Standardschriftart anstelle der benutzerdefinierten Schriftart angezeigt.

Geräteinformationseinstellungen

Sie können einige Standardeinstellungen für diesen Renderer ändern, einschließlich des Modus für das Rendern. Ändern Sie dazu die Geräteinformationseinstellungen. Weitere Informationen finden Sie unter HTML Device Information Settings.

Zugehöriger Inhalt