Template-basierte HTML Reports – Erzeugung optionaler Informationen

Im vorigen Artikel (Template-basierte HTML Reports) wurden die verschiedenen Komponenten des Template-basierten HTML Report erläutert. In diesem Artikel erfahren Sie, wie Sie zusätzliche Seiten zu Ihrem benutzerdefinierten Report hinzufügen können.

Hinweis: Die optionalen Seiten sind seit pdfToolbox 14 (pdfaPilot 12) verfügbar –  die optionalen Seiten „Bildauflösung“ und „Kleine Objekte“ sind seit pdfToolbox 15 (und pdfaPilot 13) verfügbar.

Der PDF Report enthält eine Übersichtsseite, welche Informationen über das Dokument, die Umgebung und das ausgeführte Profil enthält. Bis pdfToolbox 14 enthielt der Report keine Informationen über Sonderfarben, Seitengröße, Farbauftrag, Gesamtfarbauftrag oder Farbauszüge. Diese Informationen können Sie ab pdfToolbox 14 zu Ihrem PDF-Report hinzufügen. Es können dafür fünf zusätzliche Seiten in der manifest.xml bestellt werden:

  • Sonderfarbinformationen
  • Seiteninformationen
  • Farbauftrag
  • Gesamtfarbauftragswarnung
  • Farbauszüge
  • Bildauflösung
  • Kleine Objekte

Alle Parameter sind in dem <x:results> Abschnitt der manifest.xml enthalten.

Hinweis: Wenn Sie die unten aufgeführten zusätzlichen Informationen nicht in Ihrer manifest.xml-Datei finden oder wenn Sie immer noch das alte Layout für die Übersichtsseite erhalten, kann dies daran liegen, dass Sie beim Upgrade auf pdfToolbox 14 die alten Bibliotheken und Ressourcen importiert haben. In diesem Fall können Sie einfach eine neue Bibliothek (einschließlich Ressourcen) erstellen, um die neue Vorlage zu erhalten, oder Sie können den alten Templateordner durch den unten angehängten Ordner ersetzen.

Wo finde ich die manifest.xml?

Die zusätzlichen Informationen können manuell über die manifest.xml bestellt werden. Der folgende Screenshot dokumentiert, wie man zur manifest.xml gelangt:

  1. Klicken Sie auf "Report erstellen…" im Ergebnisfenster und anschließend auf die Schaltfläche "Durchsuchen..."
  2. Es öffnet sich ein neues Fenster im Dateisystem, in dem der Template Ordner gespeichert ist.
  3. Der Ordner namens "overview" beinhaltet alle Komponenten für das vordefinierte Template.
  4. In diesem Ordner befindet sich die manifest.xml.

Wie können die optionalen Informationen in der manifest.xml bestellt werden?

Da es sich um optionale Seiten handelt, können Sie selbst entscheiden, ob Sie eine oder mehrere Seiten zu Ihrem Bericht hinzufügen möchten oder nicht. Die Standardeinstellung generiert keine dieser optionalen Informationen. Alle fünf Parameter sind daher in der manifest.xml mit der Zeichenfolge <!-- und --> auskommentiert:

Um eine Seite zu Ihrem Bericht hinzuzufügen, müssen Sie nur den Parameter aus dem Kommentar nehmen:

Jetzt ist der Parameter aktiv in der manifest.xml und die optionale Seite (in diesem Beispiel die Gesamtfarbauftragswarnung) wird bei der Report Erstellung generiert.

Sie möchten alle optionalen Seiten zu Ihrem Bericht hinzufügen?

Wenn Sie alle Seiten zu Ihrem PDF-Report hinzufügen möchten, stellen wir Ihnen ein Template zum Download zur Verfügung, in der alle optionalen Informationen in der manifest.xml bereits aktiv sind. Folgen Sie einfach den Anweisungen:

1. Laden Sie den Template Ordner herunter:

  • overview_with_optional_pages.zip: Ab pdfToolbox 14
  • overview_with_optional_pages_pdfToolbox15.zip: Ab pdfToolbox 15
overview_with_optional_pages.zip
overview_with_optional_pages_pdfToolbox15.zip

2. Kopieren Sie das heruntergeladene Template  in den vorhandenen "Templates" Ordner ein. Der Screenshot am Anfang des Artikels zeigt Ihnen, wie Sie zu diesem Ordner gelangen.

3. Bevor Sie das neue Template in pdfToolbox auswählen können, muss das Fenster erneut geöffnet werden. Danach kann in den Einstellungsoptionen das Template "PDF-Report (Übersicht mit optionalen Seiten)" ausgewählt werden.

Parameter für die optionalen Reportseiten

Die show Option

Alle Parameter für die optionalen Seiten verfügen über eine show Option.

Die Standardeinstellung ist show="1". Dies bedeutet, dass die Daten generiert werden und die optionale Seite dem Report hinzugefügt wird.

Wenn Sie Ihre eigene Vorlage verwenden möchten, können Sie show="0" setzten.  Dadurch werden die Daten für den Parameter generiert, aber die optionale Seite wird dem Report nicht hinzugefügt.

Gesamtfarbauftragswarnung 

<x:inkamountheatmaps resolution="20" threshold="300" pageselector="all" onlyproblems="1" show="1"/>
Click to copy

Erstellt eine Heatmap-Vorschau für alle oder ausgewählte Seiten, inder jeder Bereich hervorgehoben wird, der einen bestimmten Schwellenwert überschreitet. Das erzeugte Bildmaterial entspricht dem des Visualizer-Modus "Farbauftrag hervorheben".  

Optionen:

  • resolution : Auflösung in ppi für die Vorschaubilder (Default: "20")
  • threshold : Schwellenwert in % für den Gesamtfarbauftrag (Default: "300")
  • pageselector: Ausgewählte Seiten für die Vorschaubilder (Default: "all") (weitere  Informationen zum Thema Seitenselektor)
  • onlyproblems: Nur Seiten ausgeben, die Probleme haben (Default: "1") (ab pdfToolbox 15 verfügbar)
  • show: Fügt Gesamtfarbauftragswarnung zu Report hinzu (Default: "1"), show="0" erzeugt nur die Daten

Beispiel Gesamtfarbauftragswarnung

Farbauftrag 

<x:inkcoverage resolution="10" pagebox="CropBox" pageselector="all" listpages="1" show="1"/>
Click to copy

Gibt den Farbauftrag für das gesamte Dokument und pro Seite wieder. Die Informationen zum Farbauftrag können sich auf alle oder ausgewählte Seiten beziehen. Bei großen Dateien kann die Erstellung dieser Seite einige Zeit in Anspruch nehmen, da alle Seiten gerendert werden müssen. 

Optionen

  • resolution: Auflösung in ppi für die Bestimmung des Farbauftrags (Default: "10")
  • pagebox: Seitengeometrierahmen für Farbauftrag (Default: "CropBox")
  • pageselector: Ausgewählte Seiten für den Farbauftrag (Default: "all") (weitere Informationen zum Thema Seitenselektor)      
  • listpages: Listet Farbauftrag für das gesamte Dokument und pro Seite auf (Default: „1“), listpages=„0“ listet nur den Farbauftrag für das gesamte Dokument auf 
  • show: Fügt Farbauftrag zu Report hinzu (Default: "1"), show="0" erzeugt nur die Daten

Beispiel Farbauftrag

Sonderfarbinformationen 

<x:spotcolors pageselector="all" show="1"/>
Click to copy

Die Seite mit den Sonderfarbeninformationen enthält alle im Dokument verwendeten Sonderfarben, einschließlich des Sonderfarbnamens, alternativen Farbraums und -werts sowie der Seiten, auf denen die Farbe verwendet wurde. 

Optionen

  • pageselector: Ausgewählte Seiten für die Sonderfarbinformationen (Default: "all") (weitere  Informationen zum Thema Seitenselektor)           
  • show: Fügt Sonderfarbinformationen zu Report hinzu (Default: "1"), show="0" erzeugt nur die Daten

Beispiel Sonderfarbinformationen

Farbauszüge für Prozess- und Sonderfarben 

<x:separations type="spotifpresent" resolution="20" pageselector="all" show="1"/>
Click to copy

Erstellt Separationsvorschauen für die Prozesssfarben (Cyan, Magenta, Gelb und Schwarz) und Sonderfarben.

Optionen

  • resolution: Auflösung in ppi für Vorschaubilder (Default: "20")
  • type: Typ für Farbauszüge, einer von (verfügbar ab pdfToolbox 15):
    • „all": alle Farbauszüge (Farbauszüge für Prozess- und Sonderfarben werden immer erzeugt)
    • „process": nur Separationsvorschauen für Prozesssfarben
    • „spot": nur Separationsvorschauen für Sonderfarben
    • "spotifpresent": Separationsvorschauen für Prozesssfarben und nur Sonderfarbseparationen, wenn das Dokument Sonderfarben enthält (Default)
  • pageselector: Ausgewählte Seiten für die Seperationsvorschaubilder (Default: "all") (weitere  Informationen zum Thema Seitenselektor)           
  • show: Fügt Farbauszüge zu Report hinzu (Default: "1"), show="0" erzeugt nur die Daten

Beispiel Farbauszüge

Seiteninformation 

<x:pageinfo pageselector="1" resolution="20" safetyzoneinside="3mm" safetyzoneoutside="3mm" usebleedbox="0" unit="mm" show="1"/>
Click to copy

Erzeugt standardmäßig eine Seiteninformation für die erste Seite. Diese enthält die Größen aller Seitengeometrierahmen sowie Informationen über die Seitendrehung und den Seitenskalierungsfaktor. Wenn ein Seitenskalierungsfaktor vorhanden ist, erhalten Sie auch die effektiven Größen der Geometrierahmen. Ein Vorschaubild mit einer vordefinierten Sicherheitszone und hervorgehobener TrimBox und BleedBox ist ebenfalls Teil der Seite. Zusätzlich erhalten Sie die Information, ob alle Seiten des Dokuments die gleiche Größe haben oder nicht. 

Wenn mehrere Seiten unter "pageselector" angegeben sind, wird nur die erste Seite für den Report berücksichtigt.

Optionen

  • resolution:  Auflösung in ppi für Vorschaubild (Default: "20")        
  • pageselector: Ausgewählte Seiten für die Seiteninformation (Default: "all") (weitere  Informationen zum Thema Seitenselektor)    
  • safetyzoneinside:  Sicherheitsabstand innen (Default: "3mm")
  • safetyzoneoutside :  Sicherheitsabstand außen  (Default: "3mm")
  • usebleedbox:  Verwende Größe der BleedBox (sofern vorhanden) (Default: "0")
  • unit: Einheit für Größe der Seitengeometrierahmen. Optionen: mm, pt, cm, inch (Default: "mm")              
  • show: Fügt Seiteninformation zu Report hinzu (Default: "1"), show="0" erzeugt nur die Daten

Beispiel Seiteninformation

Bildauflösung 

<x:imageresolution type="img" resolution="20" imgthreshold="150" bmpthreshold="550" onlyproblems="1" pageselector="all" show="1"/>
Click to copy

Auf dieser Seite werden für alle oder ausgewählte Seiten alle Bilder, deren Bildauflösung unter dem angegebenen Schwellenwert liegt, farblich hervorgehoben. Das erzeugte Bildmaterial entspricht dem Visualizer „Bildauflösung hervorheben“.  

Optionen:

  • type: Art des Bildes, eines von:
    • "all": Alle Bildarten
    • "img": Farb- und Graustufenbilder  (Default)
    • "bmp": Bitmap Bilder
  • resolution: Auflösung in ppi für die Vorschaubilder (Default: "20")
  • imgthreshold:  Schwellenwert in ppi für Farb- und Graustufenbilder (Default: "150")
  • bmpthreshold: Schwellenwert in ppi für Bitmap Bilder (Default: "550")
  • onlyproblems: Nur Seiten ausgeben, die Probleme haben (Default: "1")
  • pageselector: Ausgewählte Seiten für die Seiteninformation (Default: "all") (weitere  Informationen zum Thema Seitenselektor)               
  • show: Fügt "Bildauflösung" zu Report hinzu (Default: "1"), show="0" erzeugt nur die Daten

Beispiel Bildauflösung

Kleine Objekte 

<x:smallobjects type="all" threshold="medium" resolution="20" onlyproblems="1" pageselector="all" show="1"/>
Click to copy

Auf dieser Seite werden für alle oder ausgewählte Seiten Objekte mit zu dünnen Linien und/oder zu kleinem Text, die einen definierten Schwellenwert unterschreiten, farblich hervorgehoben. Das erzeugte Bildmaterial entspricht dem Visualizer „Sehr kleine Objekte hervorheben“.

Optionen:

  • type: Art der Seitenobjekte, eines von:
    • "all": alle Ansichten kleiner Objekte (Default)
    • "text": kleine Textobjekte unterhalb des Schwellenwertes
    • "lines": kleine Vektorobjekte  unterhalb des Schwellenwertes
  • resolution: Auflösung in ppi für die Vorschaubilder (Default: "20")
  • threshold: Schwellenwert für die Hervorhebung von kleinen Objekten, einer von:
    • "low": niedriger Auflösung (0,2 pt einfarbige Linien & 0,5 pt mehrfarbige Linien, 8 pt einfarbiger Text & 10 pt mehrfarbiger Text)
    • "medium": mittlerer Auflösung (Standard) (0,125 pt einfarbige Linien & 0,25 pt mehrfarbige Linien, 5 pt einfarbiger Text & 9 pt mehrfarbiger Text)
    • "high": hohe Auflösung (0,125 pt einfarbige Linien & 0,25 pt mehrfarbige Linien, 5 pt einfarbiger Text & 8 pt mehrfarbiger Text)
  • onlyproblems: Nur Seiten ausgeben, die Probleme haben (Default: "1")
  • pageselector: Ausgewählte Seiten für die Seiteninformation (Default: "all") (weitere  Informationen zum Thema Seitenselektor)             
  • show: Fügt "Kleine Objekte" zu Report hinzu (Default: "1"), show="0" erzeugt nur die Daten

Beispiel kleine Objekte