Step by step - Learn how to use callas productscallas pdfToolbox Reports for ProfilesHTML based custom reports – generate optional information

HTML based custom reports – generate optional information

The previous article (HTML based custom reports) explained the different components of the HTML based custom report. In this article you will learn how to add additional pages to your custom HTML report.

Note: The optional pages are available since pdfToolbox 14.

The custom PDF report contains an overview page that summarizes information about the preflighted document, the environment and information about the executed profile with a list of Errors, Infos, Warnings and Fixups. Until pdfToolbox 14 the report did not provide any information about spot colors, page size, ink amount, ink coverage or seperation previews. Now you have the possibility to order five additional pages in the manifest.xml that are then added to your custom PDF report:

  • Page information
  • Ink coverage
  • Ink amount
  • Spot color information
  • Separation preview

All the parameters are part of the <x:results> section of the manifest.xml.

How to open the manifest.xml?

The additional information can be ordered manually via the manifest.xml. The following screenshot documents how to get to the manifest.xml:

  1. When generating a report, click on the "Browse…" button in the settings section.
  2. A new window into the file system opens where the Template folder is stored. 
  3. The overview folder is the predefined Template folder.
  4. In this folder the manifest.xml ist stored.

How to order the optional information in the manifest.xml?

Since these pages are optional, you decide if you want to add one or all pages to your report or not. The default is that none of these information will be generated and added to the report. All five parameters are commented out in the manifest.xml with  <!-- and -->:

To add one page to your report all you have to do is uncomment the parameter:

Now the parameter is uncomment and present in the manifest.xml.

You want to add all optional pages to your report?

If you want to add all pages to your PDF report, we provide a template for download, where all optional information in manifest.xml is already uncommented. Just follow the instructions:

1. Download the Template below.

2. Add the downloaded template to the "Templates" folder. The screenshot at the beginning of the article shows you how to get to the template folder.

3. In order to display the new template in pdfToolbox, the "Save" dialog must be opened again. Then the template "PDF report (Overview with optional pages)" can be selected in the settings options.

Parameters for the optional report information

The show option

All optional information parameters have a show option.

The default for the show option is show="1". This means that the data will be generated and the optional page will be added to the report.

If you want to use your own template you can set show="0".  This will generate the data for the specific parameter, but not the optional report page.

Ink amount heatmaps

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

Creates ink amount heatmap previews and show ink amount for all pages or selected pages by highlighting any area of the file that goes over a certain threshold. The visuals that are created are similar to the visualizer mode "Ink coverage".  

Parameters

  • resolution : Resolution in ppi for ink amount previews (Default: "20")
  • threshold : Threshold in % for ink amount previews (Default: "300")
  • pageselector: Selected pages for previews (Default: "all") (click here for full pageselector syntax)
  • show: Add ink amount section to custom report (Default: "1"), show="0" will only generate the data

Example ink amount report page

Ink coverage

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

If present the page "Ink coverage" is added to the PDF report. The ink coverage information can refer to all or selected pages. For large files, the creation of this page may take some time, since all pages must be rendered. 

Parameters

  • resolution: Resolution in ppi for ink coverage determination (Default: "10")
  • pagebox: Page box for ink coverage (Default: "CropBox")
  • pageselector: Selected pages for ink coverage information in custom report (Default: "all") (click here for full pageselector syntax)             
  • show: Add ink coverage section to custom report (Default: "1"), show="0" will only generate the data

Example ink coverage report page

Spot color information

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

If present the spot color information is generated. The spot color information page will contain all used spot colors including the spot color name, the alternate color space and value and on which pages the color has been used. 

Parameters

  • pageselector: Selected pages for spot color information in custom report, default: "all" (click here for full pageselector syntax)
  • show: Add spot color section to custom report (Default: "1"), show="0" will only generate the data

Example Spot color report page

Seperation preview for Process and Spot colors

<x:separations resolution="20" pageselector="all" show="1"/>

Creates separation previews for process separation (Cyan, Magenta, Yellow and Black) and spot color separation.

Parameters

  • resolution: Resolution in ppi for separation previews (Default: "20")
  • pageselector: Selected pages for previews (Default: "all") (click here for full pageselector syntax)
  • show: Add separation preview section to custom report (Default: "1"), show="0" will only generate the data

Example separation preview report page

Page information

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

Generates a page information for the first page by default. This provides the sizes of all page geometry boxes, as well as an information about the page rotation and the page scaling factor. If a page scaling factor is set, you also get the effective sizes of the geometry boxes. A preview images with a predefined safety zone and highlighted TrimBox and BleedBox is also part of the page. Additionally you get the information if all pages of the document have the same size or not. 

If multiple pages are specified in the pageselector, only the first selected page will be considered for the template report.

Parameters

  • resolution:  Resolution in ppi for safety zone preview (Default: "20")        
  • pageselector: Selected pages for previews (Default: "1") (click here for full pageselector syntax)
  • safetyzoneinside:   Safety zone inside  (Default: "3 mm")
  • safetyzoneoutside :  Safety zone outside (Default: "3 mm")
  • usebleedbox:  Use bleed box if existing (Default: "0")
  • unit: Unit for page geometry boxes. Options: mm, pt, cm, inch (Default: "mm")              
  • show:  Add page information section to custom report (Default: "1"), show="0" will only generate the data

Example page information report page