ZUGFeRD Template erstellen
Wenn Sie eine ZUGFeRD PDF erstellen wollen, benötigen Sie ein Jaspersoft Report Template im *.jasper Format. Die Templates können Sie ganz einfach über Jaspersoft Studio erstellen.
Wir stellen Ihnen bei der Installation 3 Demo Templates zur Verfügung, diese müssen Sie nur nach Ihren wünschen Anpassen oder Sie beauftragen uns die gewünschten Änderungen vorzunehmen.
Bitte beachten Sie, dass Sie eine Arial Font Jar benötigen, um unsere Templates benutzen zu können. siehe Font JAR erstellen (Die erstellte Font jar, muss in den Ordner '/i-effect/V2R7M0/Mapper/LIB' Ordner kopiert werden und anschließend muss das EDI Subsystem gestartet werden.)
Verändern der Demo Templates
Starten Sie Japsersoft Studio mit Ihrem workspace falls Sie noch keinen workspace haben erstellen Sie sich einen an einer beliebigen Position.
Erstellen Sie sich ein neues JasperReports Project mit Rechtsklick auf Project Explorer new → Project → Jaspersoft Studio → JasperReports Project und vergeben Sie einen beliebigen Namen.
Gehen Sie nun unter /home/ieffect/zugferd/templates/ und wählen Sie einen der Demo Reports aus. Sie finden Demo Beispiele der PDF Dateien unter dem Ordner samples. Bei der menten Rechnung, liefern wir Ihnen außerdem einen Testdaten Satz in der Schnittstelle bereits mit.
Kopieren Sie sich nun die Ordner resources, subreports und die Daten aus dem Hauptordner in Ihres JasperReport Project.
Erstellen Sie sich nun einen neuen DataSource Adapter, in diesem Fall mit dem Namen ZUGFeRD Adapter im Repository Explorer.
Drücken Sie hierfür auf Create DataAdapter.
Wählen Sie nun aus der Liste Database JDBC Connection aus und drücken auf Next.
Setzen Sie nun den Namen des Data Adapter auf ZUGFeRD Adapter
Gehen Sie nun auf Driver Classpath und drücken dort auf add. Dort gehen Sie in den Installations Ordner von Jaspersoft Studio und wählen Sie die jt400.jar aus.
In meinem Fall wäre das TIBCOJaspersoftStudio-6.3.0.final-windows-x86_64 → jaspersoftstudio → jt400.jar.
Gehen Sie nun wieder auf Database Location und tragen dort folgende Informationen ein.
JDBC Driver | com.ibm.as400.access.AS400JDBCDriver |
JDBC URL | jdbc:as400://SystemName/ieffect |
Username | Ihr Benutzername auf der AS400 |
Passwort | Ihr Passwort auf der AS400 |
Nun Testen Sie ob sie die Verbindung erfolgreich eingerichtet haben, dafür drücken Sie nun auf Test, wenn dort die Meldung Successful erscheint haben Sie den Data Adapter erfolgreich eingerichtet.
Nun können Sie mit der Veränderung der Jaspersoft Templates beginnen. Wenn Sie noch nie mit Jaspersoft Studio gearbeitet haben empfehlen wir Ihnen den Getting Started Guide von Jaspersoft.
Wenn Sie die Änderungen vorgenommen haben, kopieren Sie alle angepassten Templates zurück auf Ihre System. Es ist wichtig das Sie die Templates vorher kompilieren denn das *ZUGFeRD Modul benötigt die vorkompilierten Report Dateien(.jasper).
Wenn Sie nur die Logos anpassen wollen, dann ersetzen Sie einfach das logo.png und das logo_footer.png in den resources Ordner.
Hinweise für die Erstellung eines ZUGFeRD Templates
Benutzen Sie bei der Erstellung des ZUGFeRD Templates bitte die folgenden ZUGFeRD Tabellen.
Bibliothek: IEFFECT
ZF2INVHT (Kopf Informationen)
ZF2INVTX (Allgemeine Freitexte)
ZF2INVPI (Gruppierung von Positionsangaben)
ZF2INVPP (Artikelattribute)
ZF2INVPC (Detailinformationen zur Produktklassifikation)
ZF2INVIP (Detailinformationen zu enthaltenen Produkten)
ZF2INVDR (Detailangaben zu einer zusaätzlichen Dokumentenreferenz)
ZF2INVUDR (UltimateCustomerReferencedDocument)
ZF2INVBR (Detailinformationen zur Buchungsreferenz)
ZF2INVAC (Detailinformationen zu Zu- und Abschlägen)
ZF2INVTI (Detailinformationen zu Steuerangaben)
ZF2INVDM (Detailinformationen zur Versandmethode)
ZF2INVPT (Zahlungsanweisungen)
ZF2INVSC (Detailinformationen zu logistischen Servicegebühren)
ZF2INVTP (Detailinformationen zu Zahlungsbedingungen)
ZF2INVAP (Steuerliche Angaben zu erhaltenen Anzahlungen)
Wo müssen meine Report Templates liegen?
Legen Sie Ihre Templates bitte unter /home/ieffect/zugferd/templates in einem eigenen Ordner ab. Beachten Sie das maximal eine .jasper Datei im Hauptordner liegen darf.
Beispiel:
Wo wähle ich aus, welches Template für die ZUGFeRD generierung benutzt wird?
Das können Sie, wenn im RUNMAP aufruf tun oder Sie tragen die Template Directory in dem Datensatz direkt ein. Mehr dazu finden Sie unter ZUGFeRD 2.0 Tutorial 1 , Erstellen einer ZUGFeRD PDF im Greenscreen oder ZUGFeRD 2.0 Tutorial 1 , Erstellen einer ZUGFeRD PDF in Webcontrol.
Wie müssen meine Resource_Bundles heißen und wo müssen diese liegen?
Die Namensgebung für ein Resource_Bundle muss wie folgt aussehen:
Es wird automatisch die Sprache genommen die, die aktuelle Java Instance hat.
Ihre Resource_Bundles müssen unter /home/ieffect/zugferd/templates/"Ihr Template Ordner"/resources liegen.
Wichtige Parameter für die Erstellung des Reports
Parametername | Parameterdefinition | Parameterbeschreibung |
---|---|---|
RESOURCE_PATH | STRING(Text basierter wert) | Pfad zum Standort der .jasper Datei |
HTKEY | STRING(Text basierter wert) | Rechnungsnummer der Rechnung die gerade Verarbeitet wird |