Den PDF-Generator konfigurieren

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