Formulare

Formulare repräsentieren die Darstellung eines Businessobjektes in druckbarer Form und beziehen sich immer auf einen bestimmten Datensatz aus einem Businessobjekt (Auftrag, Rechnung, Lieferschein…).

Auf welchen Datensatz (und damit auf welches Businessobjekt) innerhalb der Datenquelle sich das Formular bezieht, wird über den Parameter intid angegeben. Dieser Parameter muss in einer für Formulare verwendeten Datenquelle definiert werden. Das Abfrageergebnis, aus dem die Feldinhalte eines Formulars gefüllt werden, sollte immer ein einziger Datensatz sein.

Formulare werden über die Verwendung (blau) an einem bestimmten Businessobjekt gebunden. Aus dem Businessobjektkontext heraus (z.B. aus der Detailansicht in dem Businessobjekt Auftrag) kann das Formular über die Druckfunktion generiert werden. Dabei wird der Parameter intid automatisch mit dem Identifizierer des in der Detailmaske geöffneten Datensatzes gefüllt.

Für ein Formular können verschiedene Druckprofile angelegt werden, die ein Ergebnis in einem wählbaren Dateiformat liefern (pdf, csv, xls, xlsx, ...).

PDF - Formulare mit Jasper Reports

Ein häufiger Anwendungsfall ist die Erstellung eines PDF-Dokumentes. Dazu muss im Druckprofil eine Vorlage-Datei von Jasper Reports (.jrxml) hinterlegt werden. Alternativ kann diese Vorlage-Datei auch als Ressource in Nuclos hinterlegt werden und diese Ressource dann als Vorlage angegeben werden. Das ist vorteilhaft, wenn die gleiche Vorlage für mehrere Druckprofile (auch in anderen Formularen) verwendet wird. 

In der Regel gehören zu einem Datensatz abhängige Datensätze (z.B. Auftragspositionen). Ist das der Fall, kann ein Subreport verwendet werden, welcher die Darstellung mehrerer Datensätze der Abhängigkeiten erlaubt. Subreports werden durch Jasper-Parameter realisiert, die an das Jasper-Hauptformular im Druckprofil (Vorlage) als Parameter weitergeleitet werden. Auch hier hat man die Wahl, eine Datei oder eine Ressource anzugeben. Zusätzlich können Sie auch Text-Parameter an den Report weitergeben, um die gleiche Datenquelle und Vorlage für verschiedene Ergebnisse zu verwenden (z.B. Angebot mit und ohne Summary).

Ausgabeformat

Als Ausgabeformate stehen CSV, HTML, PDF, XLS (Excel) und XML zur Verfügung.

Ausgabemedium kann entweder „Datei“ (der Report wird erzeugt und als Datei abgelegt, aber nicht geöffnet) oder „Anzeige“ sein (der Report wird erzeugt, als Datei abgelegt und anschließend geöffnet).

Die gewählte Vorlage wird vor der (ersten) Ausgabe in das Zielverzeichnis kopiert (bzw. im Fall von PDF handelt es sich um eine XML-Datei, die von Jasper-Reports für die Formatierung der Ausgabe verwendet wird) und erlaubt so eine einheitliche Gestaltung der Reports.

Nach dem Speichern kann der Report im Menü Businessobjektten unter Reporting ausführen gestartet werden. Falls bei einem Einzelausgabe-Report mehrere Ausgabeformate festgelegt wurden, erscheint eine Liste mit allen zur Auswahl stehenden Formaten. Es kann immer nur ein Format ausgewählt werden.