This configurator drives Apago PDFspy 1.0. It is a processor that tells PDFspy to dump a number of statistics about a PDF file in an XML file, and then picks-up that XML file as metadata that gets associated with the PDF file's internal job ticket. The PDF file itself remains unchanged.
See Picking up metadata and Using metadata for more information on handling metadata in Switch.
Refer to the Apago web site for information on the third-party application required by this configurator, and refer to the PDFspy product documentation for details on the format of the XML file produced by this configurator.
Keywords can be used with the search function above the Elements pane.
The keywords for the Apaga PDFspy configurator are:
This configurator implements the following mechanisms to detect the presence of the corresponding third-party application. See Detecting third-party applications for more information.
Detection mechanism |
Comments |
---|---|
Automatic detection at startup |
Uses information registered with the operating system when the application is installed |
Searching from the elements pane |
Same as above |
Manually locating the executable |
Select the executable for the command-line version of the application |
This configurator allows only a single outgoing connection.
To install and license Apago PDFspy for use with Switch, follow these steps:
Unpack the Apago PDFspy package and put its contents in a permanent location on the system that also runs Switch (for example, in the folder that contains your other applications).
License Apago PDFspy as described in its documentation, using a valid license key obtained from Apago or from an authorized reseller (Enfocus does not sell or distribute third-party software). If you skip this step you can use Apago PDFspy in trial mode for a limited amount of time.
Start Switch; in the elements pane (NOT in the canvas) right-click on the Apago PDFspy icon; in the resulting context menu select the "set path to application..." menu item; browse to the Apago PDFspy command-line application.
To help limit the size of the metadata XML file, the configurator provides properties indicating which types of statistics should be included. If all properties are set to "exclude", the configurator (through PDFspy) still produces a minimal set of basic file statistics.
The word in parenthesis at the end of each property's description is the PDFspy command line keyword corresponding to this property.
Property |
Description |
---|---|
Name |
The name of the flow element displayed in the canvas |
Dataset name |
A name for the set of metadata picked up by this tool; see picking up metadata |
Pages |
In/exclude statistics on each individual page in the PDF file (pagedata) |
Fonts |
In/exclude statistics on typefaces used in the PDF file (fonts) |
Color spaces |
In/exclude statistics on color spaces used in the PDF file (color) |
Images |
In/exclude statistics on images contained in the PDF file (images) |
OPI comments |
In/exclude statistics on OPI comments contained in the PDF file (OPI) |
Bookmarks |
In/exclude statistics on bookmarks contained in the PDF file (outlines) |
Annotations |
In/exclude statistics on annotations contained in the PDF file (annots) |
Links |
In/exclude statistics on hyperlinks contained in the PDF file (links) |
Actions |
In/exclude statistics on PDF actions contained in the PDF file (actions) |
Names |
In/exclude statistics on PDF names contained in the PDF file (names) |
Forms |
In/exclude statistics on PDF forms contained in the PDF file (forms) |
XMP packet |
In/exclude a complete copy of the XMP packet embedded in the PDF file, if any, with the statistics (XMP) |