Page Comparison

Empfehlungen für Reports vom Typ Auswertungen Auswertung und Sub-Auswertung.

Bilder / Image Behandlung

Vektor basiertes Bild-Format verwenden.

...

• ImageQuality -> Low oder Lowest - das sollte für Business Anwendungen reichen

• PDF-A Standard (PDF/A-2a) https://www.adobe.com/de/acrobat/resources/document-files/pdf-types/pdf-a.html

• Convert Images auf true

• RasterizeImages auf false damit Vektoren nicht konvertiert werden

Reihenfolge der Bänder auf einem Report

Um den Aufbau und das Verhalten der Reports designen zu können ist es wichtig den Aufbau der Bänder zu verstehen. Das folgende Bild zeigt die Reihenfolge der Bänder ein in einem DevExpress Report. Zu beachten ist, dass der Page Header auf der ersten Seite nach dem Report Header angezeigt wird.

...

Siehe https://docs.devexpress.com/XtraReports/2587/detailed-guide-to-devexpress-reporting/introduction-to-banded-reports

Grundsätze Report Design

Allgemein

Grundsätzlich soll wie folgt designt werden:

• Page Margins auf 0 stellen damit Randabfallende Header/Footer Designs umgesetzt werden können.

  • Image Added

• 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 abhängige Relationen anzuzeigen

• Report- oder Page Header/Footer sollten sich auf das einzelne Objekt beziehen

• Bei den Einstellungen Einzelobjekt Report berücksichtigen! Siehe https://encodo.atlassian.net/wiki/spaces/EB/pages/636092439/Reporting#Auswertung-Details

  • Image Added

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.

• Beachten das der 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.

Übersetzung von Reports

• Wo immer möglich Captions aus der Datenquelle verwenden. Siehe https://encodo.atlassian.net/wiki/spaces/EB/pages/636092439/Reporting#Datenanbindung

  • Image Added

• Restliche Labels mit konstantem Text per Hamburger-Menu → Localization übersetzen.

  • Image Added

  • Siehe https://devexpress.github.io/dotnet-eud/reporting-for-web/articles/report-designer/report-designer-tools/localization-editor.html

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. Siehe https://devexpress.github.io/dotnet-eud/reporting-for-web/articles/report-designer/localize-reports.html Image Added

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 :n Relationen

• Quino-Sub-Report

  • Spezifischer Typ für die optimierte Benutzung von :1 und :n Relationen

    • Filterung 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 etwas ein bestimmtes Design resp. ein Teilreport an mehreren stellen Stellen wiederverwendet werden kann, sollte eine ein Sub-Report verwendet werden.

Optimierungen sind mit dem Quino-Sub-Report möglich.

• Siehe https://encodo.atlassian.net/wiki/spaces/EB/pages/636092439/Reporting#Quino-Sub-Report

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:

• Statische Header oder Footer können in den Margin-Bändern untergebracht werden

• Diese werden immer angezeigt

Dynamische Designs

Um Das dynamische Design muss in den folgenden Situationen angewendet werden:

• 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 0 gesetzt.

  • Steuerung der Dynamik mit Hilfe der DevExpress Funktionen, z.B. des Page Headers:

  • Image Added

• 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 :1 oder :n Relationen stammen und wiederholt angedruckt werden → mit effizienteren QuinoSubReport:n Relationen 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