PDF Creator

	PDF Creator: Transformiert ein XML-Dokument mithilfe eines XSLT-Stylesheets in ein XSL-FO-Dokument. Dieses wird im selben Prozessschritt über den XSL-FO-Prozessor Apache FOP 1.0 in ein seitenorientiertes Ausgabemedium umgewandelt. Mögliche Ausgabeformate für Reports sind PDF, PDF/A und PostScript.

Apache FOP-spezifische Anpassungen, wie zum Beispiel das Einbinden von Schriftarten in eine pdf-Datei, können direkt in der Konfigurationsdatei X4DB/0/fopuserconfig.xml vorgenommen werden.

Eigenschaften

Document	Pfad zur verknüpften Datei im Repository
Component Parameters	Component Parameter. Weitere Informationen hierzu finden Sie unter Component Parameter verwenden.
Report type	Ausgabeformat des Reports Mögliche Werte: PDF: PDF-Dokument (Portable Document Format) PDF/A: PDF-Dokument im Archivierungsformat PDF/A-1b gemäß ISO 19005-1 ; siehe Hinweis unten PS: PostScript-Datei Für die PDF/A-Option fordert Apache FOP 1.0 für jeden Textblock innerhalb des FO-Dokuments explizit die Festlegung einer Schriftart über das Attribut font-family. Zudem müssen sämtliche verwendeten Schriftarten auf dem System während der PDF/A-Erzeugung verfügbar sein.

Reports erstellen mit XSL-FO

Mit dem Baustein PDF Creator können Sie zur Laufzeit eines Prozesses dynamisch Dokumente für die Druckausgabe (Reports) generieren. Ein Report ist ein spezielles XSL-Mapping, das XML-Daten transformiert und ein XML-Dokument mit XSL-FO-Anweisungen ausgibt. Das erzeugte XSL-FO-Dokument wird der X4 BPMS direkt in das angegebene Ausgabeformat umgewandelt und an den nachfolgenden Prozessschritt weitergegeben.

Die X4 BPMS verwendet Apache FOP als XSL-FO-Prozessor zum Verarbeiten der Reports. 

Über das XSL-FO-Element <fo:external-graphic src="url('Pfad/zur/Datei.png')"> können Grafikdateien (z. B. GIF, JPEG, PNG, SVG) ins Report-Dokument eingebunden werden. Um Grafiken aus dem Repository der X4 BPMS einzubinden, können Sie deren Pfad mit einer xstore:/-URL angeben, z. B.:

<fo:external-graphic src="url('xstore://Project/Folder/File.png')" 
    content-width="10mm" content-height="10mm"/>

Mit den optionalen Attributen content-width und content-height können Sie Breite und Höhe des Bilds im Ausgabedokument bestimmen.

Alternativ können Sie binäre Grafikdateien auch als Base64-kodierte Zeichenkette in den Report nach folgendem Muster einbetten. Weitere Informationen hierzu finden Sie unter Base64 Converter:

HTML/XML

<fo:external-graphic src="url(data:;base64,Base64-kodierte Bilddaten)"/>

Bei SVG-Bildern kann zudem deren Quellcode direkt in den Report eingebettet werden, z. B.:

HTML/XML

<fo:instream-foreign-object>
   <svg:svg xmlns:svg="http://www.w3.org/2000/svg" 
    height="1mm" width="40mm">
    <svg:line y1="0" y2="0" x1="0" x2="40mm"
     style="stroke:#0000FF;stroke-width:0.5pt" />
   </svg:svg>
</fo:instream-foreign-object>

Achten Sie hierbei darauf, dass alle SVG-Elemente den Namespace svg: besitzen.

Beispiel

Im Folgenden ein Beispiel für ein sehr einfaches (minimales) XSL-FO-Dokument:

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">  
  <fo:layout-master-set> 
    <fo:simple-page-master master-name="simple" page-height="29.7cm" 
    page-width="21cm" margin-left="2.5cm" margin-right="2.5cm"> 
      <fo:region-body margin-top="3cm"/> 
    </fo:simple-page-master> 
  </fo:layout-master-set>  
  <fo:page-sequence master-reference="simple"> 
    <fo:flow flow-name="xsl-region-body"> 
      <fo:block>Hello World</fo:block> 
    </fo:flow> 
  </fo:page-sequence> 
</fo:root>

Weitere Informationen zum Thema Hyphenation finden Sie unter https://xmlgraphics.apache.org/fop/2.5/hyphenation.html.