Empfehlungen für Reports vom Typ Auswertungen Auswertung und Sub-Auswertung.
| Table of Contents | ||
|---|---|---|
|
Bilder / Image Behandlung
...
Grundsätze Report Design
Allgemein
Grundsätzlich soll wie folgt designt werden:
Page Margins auf
0stellen damit Randabfallende Header/Footer Designs umgesetzt werden können.Verwendung von Panels und Tabellen um die Controls hierarchisch zu verschachteln resp. auszurichten.
Design für Einzel-Objekte vs. Listen
Einzel-Objekt: Ziel ist ein einzelnes Objekt darzustellen und abhängige Relationen anzuzeigen
Report- oder Page Header/Footer sollten sich auf das einzelne Objekt beziehen
Bei den Einstellungen
Einzelobjekt Reportberücksichtigen! Siehe https://encodo.atlassian.net/wiki/spaces/EB/pages/636092439/Reporting#Auswertung-Details
Liste: Ziel ist eine Listendarstellen eines Typs
Zuerst prüfen ob die Möglichkeiten der Liste mit PDF und Excel Export genügend sind! Erst bei expliziten Designs eine Auswertung erstellen.
Der Report-Header/Footer wird nur einmal vor der Liste und einmal am Ende angezeigt. Spaltenüberschriften müssen mit PageHeader oder alternativ mit GroupHeader gelöst werden.
Detail Report vs. Sub-Report
Wenn die Darstellung einer Relation oder Liste nur innerhalb eines Reports verwendet wird, dann sollte ein Detail-Report verwendet werden, da dieser einfacher zu integrieren ist. Sobald ein bestimmtes Design resp. ein Teilreport an mehreren Stellen wiederverwendet werden kann, sollte ein Sub-Report verwendet werden.
Sub-Report Typen
Sub-Report von DevExpress direkt
Geeignet für statische Elemente oder Master-Detail Reports von
:nRelationen
Quino Sub-Report
Spezifischer Typ für die optimierte Benutzung von
:1RelationenSiehe https://encodo.atlassian.net/wiki/spaces/EB/pages/636092439/Reporting#Quino-Sub-Report
Grundsätze Design
Grundsätzlich soll wie folgt designt werden:
Linken und rechten Seitenrand auf 0 stellen damit Randabfallende Header/Footer Designs umgesetzt werden könnenVerwendung von Panels und Tabellen um die Controls hierarchisch zu verschachteln resp. auszurichten
Übersetzung von Reports
Wo immer möglich Captions aus der Datenquelle verwenden. Siehe https://encodo.atlassian.net/wiki/spaces/EB/pages/636092439/Reporting#Datenanbindung
Restliche Labels mit konstantem Text per Hamburger-Menu → Localization übersetzen.
| Note |
|---|
Nie (wirklich nie!) durch Umstellen des “Language” Properties auf dem Report selber. Sonst werden auch Änderungen am Report-Layout und anderen Sachen sprach-spezifisch gemacht und das kann man eigentlich nicht mehr fixen. Der Report muss dann neu aufgebaut werden.  |
Sub-Reports
Verschachtlungen und Wiederverwendung von Reports ist möglich mit Sub-Reports. Siehe
Sub-Report Typen
Sub-Report von DevExpress direkt
Geeignet für statische Elemente oder Master-Detail Reports von
:nRelationen
Quino-Sub-ReportSpezifischer Typ für die optimierte Benutzung von
:1und:nRelationenFilterung des Reports kann für komplexere Abfragen nach der Expression Syntax verwendet werden.
Siehe https://encodo.atlassian.net/wiki/spaces/EB/pages/636092439/Reporting#Quino-Sub-Report
Detail Report vs. Sub-Report
Wenn die Darstellung einer Relation oder Liste nur innerhalb eines Reports verwendet wird, dann sollte ein Detail-Report verwendet werden, da dieser einfacher zu integrieren ist. Sobald ein bestimmtes Design resp. ein Teilreport an mehreren Stellen wiederverwendet werden kann, sollte ein Sub-Report verwendet werden.
Optimierungen sind mit dem Quino-Sub-Report möglich.
Empfehlungen für Sub-Reports
Reports die nur als Sub-Report und nicht eigenständig verwendet werden, sollten mit dem Typ
Sub-Auswertung. Diese sind damit nicht eigenständig in der Applikation ersichtlich.Sub-Auswertungen sollten nicht mehr umbenannt werden! Der Verweis zu dem Sub-Report geht über den Namen. Ist dieser nicht mehr im System vorhanden, führt das zu einem Fehler und muss im XML des Reports korrigiert werden.
Corporate Identity / Corporate Design (CI/CD)
Statische Designs
Ein statisches Design hat auf allen Seiten immer den gleichen Header und Footer. Es gibt da keinerlei Einfluss auf das Aussehen der Header und Footer aus den Daten. Vorgehen:
...
den Kopf der ersten Seite im Vergleich zu den folgenden Seiten anders zu gestalten
den Header resp. Footer aufgrund der Daten gestalten (also z.B. Bilder aus der DB)
den Abschluss des Reports zu verändern
Vorgehen:
Benutzung von Report-Bändern (Header/Footer-Bänder ) zusammen mit Page-Bändern (Header/Footer-Bändern). Alle Margins werden auf
0gesetzt.Steuerung der Dynamik mit Hilfe der DevExpress Funktionen, z.B. des Page Headers:
Wiederverwendung mittels Sub-Reports
Sub-Reports
Wiederholende Designs von Margins, Headern oder Footern können in Sub-Reports ausgelagert werden.
Fix designte, statische Elemente die nicht aus den Daten ermittelt werden -> mit normalen Sub-Reports
Informationen die aus
:1oder:nRelationen stammen und wiederholt angedruckt werden → mit effizienterenQuinoSubReport:nRelationen müssen mit Master-Detail Report abgebildet werden: https://devexpress.github.io/dotnet-eud/reporting-for-web/articles/report-designer/create-reports/master-detail-reports-with-subreports.html
Die Sub-Reports müssen in den Report jeweils eingebunden werden. Die Steuerung der Dynamik erfolgt mit den Eigenschaften der Bänder.
...
Empfehlungen:
Die Sub-Reports füllen jeweils das komplette Band (Gleiche Höhe und Breite) aus. So können unbeabsichtigte Margins vermieden werden.
Die Höhe der Bänder sollten möglichst klein gewählt werden. Der Sub-Report drückt die Höhe des Bands auf die eigene Höhe auf.
Das Design des Sub-Reports beinhaltet die Margins
Scripting
Es steht in der Web-Umgebung aus Sicherheitsgründen kein Scripting zur Verfügung
...