Seitenhistorie
| Auszug | ||
|---|---|---|
| ||
Nuclos Jasper Bänder: Titel, Page Header, Column Header, Group Header, Detail, Summary, Background, Bandhöhe, Typseite. |
Sprache: Deutsch · English
Überblick-Bands
Referenz der JasperReports-Bänder – Titel, Header/Footer, Gruppen, Detail und Background samt Höhenregeln.
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Panel | |||
|---|---|---|---|
| |||
Auf dieser Seite
|
...
|
...
|
Ein Bericht wird
...
über eine Typseite definiert
...
, die in
...
horizontale Abschnitte – Bänder – unterteilt ist. Jedes Band wird je nach Funktion unterschiedlich oft gedruckt (der Seitenkopf je Seite, das Detailband je Datensatz).
| Info | ||
|---|---|---|
| ||
Die Summe aller Bandhöhen (außer Background) muss ≤ Seitenhöhe minus oberer/unterer Rand sein. Die angegebene Höhe gilt als Mindesthöhe – Bänder mit Textfeldern/Subreports können sich nach unten dehnen. |
Die neun Standard-Bänder
| Band | Zweck |
|---|---|
| Titel | Erstes sichtbares Band, wird einmal erzeugt; optional auf separater Seite. |
| Page Header | Seitenkopf, erscheint auf jeder Seite an gleicher Position. |
| Column Header | Am Anfang jeder Detailspalte – typischerweise Spaltenüberschriften. |
| Group Header | Beginn einer Gruppe; kann Seiten-/Spaltenumbruch erzwingen und wiederholt werden. |
| Detail | Beliebig viele; wird je Datensatz wiederholt (unbegrenzte Gesamtgröße). |
| Group Footer | Schließt eine Gruppe ab – z.B. Zwischensummen, Trennlinien. |
| Column Footer | Am Ende jeder Spalte; zur Laufzeit nicht dehnbar. |
| Page Footer | Seitenfuß auf jeder Seite mit Seitenkopf; nicht dehnbar. |
| Last Page Footer | Abweichender Fuß der letzten Seite; bei Höhe 0 ignoriert. |
| Summary | Gesamtsummen/Mittelwerte am Berichtsende (anderswo „Report Footer“). |
| Background | Wasserzeichen/Rahmen über die gesamte Seite; max. Seitenhöhe. |
Detail-Bänder ergänzen
Weitere Detail-Bänder per Add Another Detail Band ans Ende anfügen. Die Reihenfolge lässt sich in der XML-Ansicht ändern: die <band>-Elemente liegen zwischen <detail>…</detail>.
Detail-Bänder in der XML-Ansicht.
Verwandte Seiten
unterteilt, die als Bänder bezeichnet werden. Wenn der Bericht mit den Daten verbunden wird, die den Druck generieren, wird dieser Abschnitt je nach ihren Funktionen (und gemäß den Regeln, die der Berichtsautor festgelegt hat) mehrmals gedruckt. Zum Beispiel wird der Seitenkopf am Anfang jeder Seite wiederholt, während das Detailband für jedes einzelne gelesene Datensatz wiederholt wird.
Was ist ein Band
Die Typseite ist in neun vordefinierte Bänder unterteilt, zu denen neue Gruppen hinzugefügt werden können. Darüber hinaus verwaltet Jaspersoft Studio für jede Gruppe ein Kopfband (Gruppenkopf) und ein Zusammenfassungsband
Die Bereiche lassen je nach Bedarf entfernen.
Ein Band ist immer so breit wie die Seitenbreite (unter Ausschluss der rechten und linken Ränder). Die Höhe des Bands kann jedoch, selbst wenn sie während der Entwurfsphase festgelegt wurde, während der Erstellung des Drucks je nach den enthaltenen Elementen variieren; es kann sich auf beliebige Weise nach unten auf einer Seite "verlängern". Dies tritt typischerweise auf, wenn Bänder Unterberichte oder Textfelder enthalten, die sich vertikal an den Inhalt anpassen müssen. Im Allgemeinen sollte die vom Benutzer angegebene Höhe als "die minimale Höhe" des Bands betrachtet werden. Nicht alle Bänder können dynamisch je nach Inhalt gestreckt werden, insbesondere die Spaltenfuß-, Seitenfuß- und letzte Seitenfuß-Bänder.
Die Summe aller Bandhöhen (mit Ausnahme des Hintergrunds) muss immer kleiner oder gleich der Seitenhöhe abzüglich der oberen und unteren Ränder sein.
Titel
Das Titelband ist das erste sichtbare Band. Es wird nur einmal erstellt und kann auf einer separaten Seite gedruckt werden. In Bezug auf die erlaubten Abmessungen ist es während der Entwurfszeit nicht möglich, die Höhe der Berichtsseite zu überschreiten (obere und untere Ränder sind eingeschlossen). Wenn der Titel auf einer separaten Seite gedruckt wird, wird die Höhe dieses Bands nicht in die Berechnung der Gesamthöhe aller Bandhöhen einbezogen, die wie zuvor erwähnt kleiner oder gleich der Seitenhöhe sein muss.
Page Header
Das Seitenkopfband ermöglicht die Definition eines Seitenkopfs. Die während der Entwurfsphase festgelegte Höhe ändert sich normalerweise nicht während des Erstellungsprozesses (außer bei der Einfügung von vertikal skalierbaren Komponenten wie Textfeldern, die langen Text enthalten, und Unterberichten). Der Seitenkopf erscheint auf allen gedruckten Seiten an der gleichen Position, die während der Entwurfsphase festgelegt wurde. Titel- und Zusammenfassungsbänder schließen den Seitenkopf nicht ein, wenn sie auf einer separaten Seite gedruckt werden.
Column Header
Das Spaltenkopfband wird am Anfang jeder Detailspalte gedruckt (das Konzept der Spalte wird später im Abschnitt "Spalten" erläutert). In der Regel werden Beschriftungen mit den Spaltennamen eines tabellarischen Berichts in dieses Band eingefügt.
Group Header
Ein Bericht kann null oder mehrere Gruppenbänder enthalten, die die Sammlung von Detaildatensätzen in realen Gruppen ermöglichen. Ein Gruppenkopf wird immer von einem Gruppenfuß begleitet (beide können unabhängig voneinander sichtbar oder nicht sichtbar sein). Unterschiedliche Eigenschaften sind mit einer Gruppe verbunden. Sie bestimmen ihr Verhalten aus grafischer Sicht. Es ist möglich, einen Gruppenkopf immer auf einer neuen Seite oder in einer neuen Spalte zu erzwingen und dieses Band auf allen Seiten zu drucken, wenn die darunter liegenden Bänder die einzelne Seite überschreiten (wie ein Seitenkopf, aber auf Gruppenebene). Es ist möglich, eine Mindesthöhe festzulegen, die erforderlich ist, um einen Gruppenkopf zu drucken: Wenn diese Höhe überschritten wird, wird das Gruppenkopfband auf einer neuen Seite gedruckt (bitte beachten Sie, dass ein Wert, der für diese Eigenschaft zu groß ist, eine Endlosschleife während des Druckens erzeugen kann).
Group Footer
Das Gruppenfußband schließt eine Gruppe ab. In der Regel enthält es Felder zum Anzeigen von Zwischensummen oder grafischen Trennelementen, wie Linien.
Column Footer
Das Spaltenfußband erscheint am Ende jeder Spalte. Seine Abmessungen sind zur Laufzeit nicht änderbar, auch nicht, wenn es skalierbare Elemente wie Unterberichte oder Textfelder mit variabler Anzahl von Textzeilen enthält.
Page Footer
Das Seitenfußband erscheint auf jeder Seite, auf der ein Seitenkopf vorhanden ist. Wie der Spaltenfuß ist es zur Laufzeit nicht änderbar.
Last Page Footer
Wenn der letzte Seitenfuß anders als die anderen Fußzeilen sein soll, kann das spezielle Band für den letzten Seitenfuß verwendet werden. Wenn die Bandhöhe 0 beträgt, wird es vollständig ignoriert, und das Layout, das für die gemeinsame Seite festgelegt wurde, wird auch für die letzte Seite verwendet.
Summary
Das Zusammenfassungsband ermöglicht das Einfügen von Feldern zu Gesamtberechnungen, Mittelwerten oder allem, was am Ende des Berichts eingefügt werden soll. In anderen Systemen wird dieses Band oft als Berichtsfuß bezeichnet.
Background
Das Hintergrundband wurde aufgrund nachdrücklicher Anfragen vieler Benutzer eingeführt, die Wasserzeichen und ähnliche Effekte erstellen wollten (wie ein Rahmen um die gesamte Seite). Es kann eine maximale Höhe haben, die der Seitenhöhe entspricht.
Detail
Es können beliebig viele Detail-Bands eingefügt werden. Dieser Bereich kann eine unendliche Größe annehmen.
Soll ein zusätzliches Detail-Band eingefügt werden, wird es mit "Add Another Detail Band" ans Ende der bestehenden Detail angefügt. In der Designer-Ansicht kann keine Veränderung vorgenommen werden.
Überblick
Inhalte