Sind die Möglichkeiten zur Anpassung des Drucklayouts unter Weitere Schritte nach der Erst-Installation nicht ausreichend, so können über den iReport weitere Anpassungen vorgenommen werden.
Es ist wichtig, dass für die nachfolgend beschriebenen Anpassungen die Version iReport Designer 6.5.1 von Jaspersoft verwendet wird.
Ab oxaion open Version 2021.5409.1 ist die Version 6.13.0 zu verwenden!
Prinzipieller Ablauf der Druckausgabe
Wird aus oxaion heraus eine Druckausgabe (auch eine Druckvorschau zählt dazu) angestoßen, findet programmtechnisch folgender Ablauf statt:
- der Dienst des Printservers prüft im Kundenverzeichnis ..\data\print\template\ ...
- ob es zum angeforderten Printbeleg eine Version (Änderungsdatum + -zeit) der .jrxml Datei gibt
- falls dies der Fall ist, wird diese kopiert in das Serververzeichnis ..\image\print\template ...
- ist im Serververzeichnis keine .jasper Datei vorhanden wird die aus der .jrxml neu erstellt
- Schritt 1. erfolgt für jedes Template, dass im angeforderten Druck verwendet wird.
- Ablauf der eigentlichen Druckausgabe
Ablauf von Printanpassungen über iReport
Im Serververzeichnis werden die Definitionen für Print ausgeliefert und gegebenenfalls durch ein neues Image aktualisiert. Anpassungen hier sind also nicht nachhaltig, daher müssen die Templates die angepasst werden sollen in das Kundenverzeichnis kopiert werden. Nur dort dürfen Anpassungen vorgenommen werden, da hier mit einem neuen Image kein Einfluss genommen wird. Es wird empfohlen nur die Templates zu kopieren, die auch angepasst werden. Hierbei sollte allerdings nicht Dateiweise, sondern Ordnerweise vorgegangen werden. Wird also bspw. das Template für die Ausgabe der Auftragsbestätigung im Verkauf angepasst, so der komplette Ordner vk20201 mit allen Inhalten von ..\image\print\template\ nach ..\data\print\template\ kopiert.
Bearbeitungen der Templates dürfen nur im Kundenverzeichnis erfolgen.
Es können nur vorhandene Templates mit dem iReport angepasst werden. Oxaion bietet neben den Printtemplates auch Druckausgaben an, die nicht auf die hier beschriebene Weise angepasst werden können. Diese Druckausgaben sind in der Regel für interne Zwecke und daher nicht als sogenannte Printbelege konzipiert.
In diesem Abschnitt sollen anhand von zwei Beispielen die notwendigen Anpassungen im Detail beschrieben werden, um das Prinzip der Möglichkeiten darzustellen.
Diese Dokumentation setzt Kenntnisse für das Programm iReport ebenso voraus, wie den Aufbau der Druckausgaben und deren Steuerung in oxaion über die Druckschablonen (OP20090).
Vorarbeiten der Anpassung
| Nummer | Schritt | Beschreibung |
|---|---|---|
| 1. | Identifizierung des verwendeten Templates | Aufruf der Druckausgabe oder der Druckvorschau für den Beleg der angepasst werden soll. Im Dialog für die Druckausgabe gibt der Druckerdateiname (meist ohne angehängtem Buchstaben) Auskunft über das verwendete Template, bzw. den Ordernamen mit den verwendeten Templates. Alternativ kann dies auch aus den Druckschablonen ermittelt werden. Dort finden sich auch die Schablonen und Parameter zur Feinsteuerung von Druckausgaben. |
| 2. | Prüfen auf vorhandene Anpassungen | Im Kundenverzeichnis ..\data\print\template\ wird geprüft ob es dort bereits einen Ordner mit dem Druckerdateiname (meist ohne angehängtem Buchstaben) gibt, falls nein, geht es mit Schritt 3 weiter. falls ja, geht es mit Schritt 5 weiter. |
| 3. | Kopieren der Templates | Aus dem Serververzeichnis ..\image\print\template wird der komplette Ordner mit den in Schritt 1 identifizierten Templates in das Kundenverzeichnis ..\data\print\template\ kopiert bzw. die Ordnerstruktur angelegt. Es wird Empfohlen auch in einem Ordner "Original" eine Sicherungskopie des Ordners zu erstellen. |
| 4. | Löschen der .jasper Dateien | Die vorhandenen .jasper Dateien können im Kundenverzeichnis ..\data\print\template\ gelöscht werden. Diese werden beim Aufruf des Drucks im Serververzeichnis automatisch erstellt. |
| 5. | Öffnen des Templates | Aufruf des Templates aus dem kopierten Ordner im Kundenverzeichnis ..\data\print\template. |
Beispiel Anpassung Verkaufs AB
Anforderung Statt dem "/" bei "Seite 1 / 2" soll ein " -- " ausgegeben werden. |
|
| Die Vorarbeiten der Anpassung sind durchgeführt, es ist also der Ordner vk20201 kopiert und das vk20201.jrxml im iReport geöffnet. | |
Es wird " / " im Editor ersetzt durch " \ ". Die Datei wird gespeichert. | |
| Es es erfolgt eine erneute Druckausgabe. | |
| Ergebnis |
|
Beispiel Anpassung Größe des Logos im Verkaufs AB
Anforderung Das Firmenlogo soll sich für den Verkaufs AB über die gesamte Seitenbreite erstrecken. Für das Firmenlogo ist im Standard ein Bereich rechts oben auf den Belegen vorgesehen. |
|
Die Herausforderung an dieser Stelle ist, dass Template für diese Anforderung zu identifizieren. In diesem Fall, ist das Logo als Background mit einem Subreport im vk20201.jrxml definiert. Dieser Subreport wiederum befinden sich im Ordner ..\all_templates und heißt background.jrxml. Das Template background.jrxml wiederum ermittelt über die Subreport Expression die firmenbezogenen Subreports. Im Umfeld von easy Medizintechnik ist der Default Subreport das Template background_firm.jrxml. Wie in Vorarbeiten der Anpassung beschrieben muss nun dieses Template vom Serververzeichnis in die gleiche Struktur im Kundenverzeichnis kopiert werden. | Änderungen in den Templates die im Verzeichnis all_templates gemacht werden, wirken sich auf alle Verwender aus. Die Verwender können über die Suchfunktion mit Angabe des Namens des Templates über alle Templateordner auf dem Filesystem gefunden werden. |
| Der Platzhalter für das Image "logo.png" wird geändert von Left 445 und Width 140 auf Left 10 und Width 575. |
|
| Das Template wird gespeichert und es erfolgt eine neue Druckausgabe. | |
Ergebnis Auf die weitere Bearbeitung wegen der Überlappung der Seitenangabe wird an dieser Stelle verzichtet. |
|
Vorgehensweise nach einem Update
Nach Einspielen eines neuen Image ist sicher zu stellen, dass die Anpassung in den Templates wieder als aktuell erkannt werden.
Im Serververzeichnis muss jede .jasper Datei gelöscht werden, deren .jrxml Datei im Kundenverzeichnis angepasst wurde.
Alternativ können über die Dateisuche im Serverzeichnis auch alle .jasper Dateien gelöscht werden. Denn diese werden beim nächsten Druckaufruf automatisch neu erstellt.