Faktura Layout Einstellungen Grafiken

Übersicht

Diese Anlegung beschreibt das Hinzufügen einer Grafik zu Ihrer Vorlage. Möchten Sie mehrere Grafiken einbinden, muss für jede weitere Grafik die Namensgebung und der entsprechende Variablenverweis angepasst werden.

Alternativ zu dieser Anleitung besteht die Möglichkeit, die gewünschte(n) Grafike(n) an einer im Web öffentlich zugänglichen Stelle zu hinterlegen und im Image-Element zu verlinken.

Eigene Grafiken in die JRXML-Vorlage einpflegen

Grafik erstellen

Erstellen oder wählen Sie die gewünschte Grafik aus und sorgen Sie dafür, dass diese in einem für Sie zugreifbaren Verzeichnis gespeichert liegt.

Grafik konvertieren

Im nächsten Schritt muss die Grafik in einen sogenannten Base64 String umgewandelt werden.

Laden Sie dazu die Grafik zB: unter

hoch, klicken Sie auf die Schaltfläche "Encode" und kopieren Sie das Ergebnis aus dem Textfeld unterhalb der Zeile "Encoded Output" in Ihre Zwischenablage.

Achtung: nur das codierte Bild selbst darf kopiert werden.

Beispiel

Üblicherweise beginnt das Bild selbst mit: iVBOR...;
Beginnt der Code zB: mit: "data:image/png;base64,iVBOR..." >
hier kopieren Sie erst ab dem "," (Beistrich) kopiert
werden, also: "iVBOR...." (bis zum Ende)

Variable anlegen

Nun öffnen Sie die Vorlage zur Bearbeitung:

1. Legen Sie im Report Inspector/Outline (Sidebar links) unter "Variables" eine neue Variable zB mit dem Namen "stream" an. 2. Legen Sie die folgenden Eigenschaften dieser Variable "stream" fest:

  • Name: stream
  • Value Class Name: java.lang.String
  • Calculation: Nothing
  • Reset type: Report
  • Reset group: [leer lassen]
  • Increment type: None
  • Increment group: [leer lassen]
  • Incrementer Factory Class: [leer lassen]
  • Variable Expression: Fügen Sie den Text aus Ihrer Zwischenablage ein - zu Beginn und am Ende muss ein doppeltes Hochkomma stehen
  • Initial Value Expression: [leer lassen]

Variable verwenden

Nun fügen Sie über die Palette ein Element vom Typ "Image" ein.

Legen Sie für das neue Image folgende Eigenschaften im Bereich "Image properties" fest:

  • Image Expression: new java.io.StringBufferInputStream( new org.w3c.tools.codec.Base64Decoder($V{stream}).processString() )
  • Expression Class: java.lang.String
  • Scale Image: Retain Shape
  • Using Cache: Aktiviert
  • Evaluation Time: Report

Image platzieren

Nun vergeben Sie für das Image-Element die gewünschte Größe, die es am Dokument haben soll und platzieren Sie es an die gewünschte Stelle im Dokument. Dafür kann es notwendig sein, die sogenannten Bands (Title, Page Header, Sumnary, Footer etc) zu vergrößern.

Bitte beachten Sie:

  • Möchten Sie den Briefkopf um eine Grafik erweitern, müsste das Image-Element sowohl im Page Header als auch im Title platziert werden. Der Bereich Title wird nur auf der ersten Seite eines Dokuments verwendet, der Page Header nur auf allen weiteren Seiten.

  • Möchten Sie zB ein Unterschrift-Bild am Ende des Dokuments verwenden, platzieren Sie die Grafik am besten unterhalb der Zeile "textAfter" und vergrößern dazu den umfassenden Frame.