Die Konfiguration des PDF-Generators beschränkt sich auf die Pfade der
zu verwendenen Layout- und XSL-Datei sowie seine eigene, vom GUI
aufzurufende URL. Diese Parameter werden direkt in der
instanzenspezifischen Menükonfiguration,
/config/contentMenu.xml, über die der PDF-Generator in den
CMS-Navigator eingebunden wird, angegeben. Siehe die Beans
createPdfManual und updatePdfManual in dieser
Datei.
Beachten Sie bitte, dass Bean-Definitionen in der Datei
contentMenu.xml nicht wirksam sind, wenn es das gleiche Bean
bereits in der Datei itemRegistry.xml gibt.
Die relevanten Konfigurationsparameter sind:
pdfDownloadUrl: die URL, die das GUI aufruft, um den PDF-Inhalt generieren und sich geben zu lassen.xslPath: Pfad zu einer ins CMS importierten Datei (beispielsweise/layout/pdfstylesheet.xsl), die das XSL-Stylesheet enthält, mit dem die XHTML-Ausgabe der Layout-Datei formatiert wird. Ist kein Pfad angegeben, wird ein internes Stylesheet verwendet.pdfTemplateName: der Name der CMS-Layout-Datei, die zur Erzeugung des HTML-Inputs des PDF-Generators verwendet wird.
Nach der Konfigurationsänderung müssen CM und GUI neu gestartet werden.
Nachdem der PDF-Generator eine PDF-Datei erzeugt und in der
CMS-Ordnerhierarchie als Ressource abgelegt hat, wird in die Ressource ein
Link auf den Quellordner eingetragen. Dadurch lässt sich die PDF-Datei
aktualisieren, ohne sich an den Pfad des Quellordners erinnern zu müssen. Der
Link wird im Linklistenfeld pdfSource gespeichert. Damit dies
möglich ist, muss dieses Feld angelegt und zu der Vorlage für die
PDF-Ressource hinzugefügt werden. Beispiel für die Felddefinition:
- Name:
pdfSource - Titel: Quelle des PDF-Dokuments
- Beschreibung: Der PDF-Generator speichert hier einen Link auf den Quell-Ordner. Dadurch kann der PDF-Generator bei Aktualisierung der PDF-Datei den Quellordner ermitteln.
- Typ: Linkliste
- Durchsuchbar im Content Manager: Nein
- Durchsuchbar im Live-Server: Nein
- Eingabefeldtyp: Linklistenfeld