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 den Reiter  Verwendung an eine bestimmtes 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“ (das Formular wird erzeugt und als Datei abgelegt, aber nicht geöffnet) oder „Anzeige“ sein (das Formular wird erzeugt, als Datei abgelegt und anschließend geöffnet).