Distiller

The Distiller service creates PDF documents from PostScript, Encapsulated PostScript (EPS), and PRN files.

For information about using the Distiller service, see Services Reference for Adobe LiveCycle ES4.

CreatePDF (Deprecated)

This operation is deprecated in LiveCycle 8.2. Use the CreatePDF operation operation instead. It is recommended that when you upgrade a process, you change it to use the CreatePDF operation operation.

Converts PostScript, EPS, and PRN files to PDF documents.

For information about the General and Route Evaluation property groups, see Common operation properties.

Input properties

Properties to specify the input document to be converted and the conversion settings to use.

Input Document

The document value that represents the content to convert to a PDF document. It must be a valid PostScript or EPS document.

If you provide a literal value, clicking the ellipsis button  displays the Select Asset dialog box. (See About Select Asset.)

Filename with Extension

(Optional) A string value that represents the file name, with the appropriate extension, of the PostScript or EPS document to be converted.

Adobe PDF settings

(Optional) A string value that represents the PDF output settings to be applied. The following options are available:

  • High Quality Print

  • Oversized Pages

  • PDFA1b 2005 CMYK

  • PDFA1b 2005 RGB

  • PDFX1a 2001

  • PDFX3 2002

  • Press Quality

  • Smallest File Size

  • Standard

    When no value is specified, the service uses the default PDF settings that are configured in Administration Console.

Security Settings

(Optional) A string value that specifies security settings. The single available option is No Security. When no value is specified, the service uses the default PDF settings that are configured in Administration Console.

Settings Document

(Optional) A document value that represents the file that contains settings to be applied while generating the PDF document, such as optimization for web view, as well as the settings that are applied after the PDF document is created, such as initial view and security.

If you provide a literal value, clicking the ellipsis button displays the Select Asset dialog box. (See About Select Asset.)

XMP Document

(Optional) A document value that represents the file that contains metadata information to be applied to the generated PDF document. Only UTF-8 encoded XMP metadata is supported. The metadata should conform to the Adobe Extensible Metadata Platform (XMP) format. For details about the format and for the specifications, see XMP Utilities.

If you provide a literal value, clicking the ellipsis button displays the Select Asset dialog box. (See About Select Asset.)

Output properties

Property for specifying the output PDF document.

Result

A map value that contains the result of the operation:

  • The key ConvertedDoc is associated with a document value, which represents the PDF document that the operation generates.

  • The key LogDoc is associated with a document value that represents a log file that can be generated during the execution of the operation.

    For information about retrieving values from a map, see Accessing data in data collections.

Exceptions

CreatePDF operation

Converts PostScript, Encapsulated PostScript (EPS), and printer text files (PRN) to PDF documents.

For information about the General and Route Evaluation property groups, see Common operation properties.

Input properties

Properties to specify the input document to be converted and the conversion settings to use.

Input Document

The document value that represents the content to convert to a PDF document. It must be a valid PostScript or EPS document. No default is provided.

If you provide a literal value, clicking the ellipsis button  displays the Select Asset dialog box. (See About Select Asset.)

Conversion options properties

Adobe PDF settings

(Optional) A string value that represents the PDF output settings to be applied. No default is provided, and the following values are valid:

  • High Quality Print

  • Oversized Pages

  • PDFA1b 2005 CMYK

  • PDFA1b 2005 RGB

  • PDFA Draft

  • PDFX1a 2001

  • PDFX1a 2003

  • PDFX3 2002

  • PDFX3 2003

  • Press Quality

  • Smallest File Size

  • Standard

    When no value is specified, the service uses the default PDF settings that are configured in Administration Console.

Advanced options properties

Filename with Extension

(Optional) A string value that represents the file name, with the appropriate extension, of the PostScript or EPS document to be converted. No default is provided.

Security Settings

(Optional) A string value that specifies security settings. The single available option is No Security. When no value is specified, the service uses the default PDF settings that are configured in Administration Console.

Settings Document

(Optional) A document value that represents the file that contains settings to be applied while generating the PDF document, such as optimization for web view, as well as the settings that are applied after the PDF document is created, such as initial view and security.

If you provide a literal value, clicking the ellipsis button  displays the Select Asset dialog box. (See About Select Asset.)

XMP Document

(Optional) A document value that represents the file that contains metadata information to be applied to the generated PDF document. Only UTF-8 encoded XMP metadata is supported. The metadata should conform to the Adobe Extensible Metadata Platform (XMP) format. For details about the format and for the specifications, see XMP Utilities.

If you provide a literal value, clicking the ellipsis button displays the Select Asset dialog box. (See About Select Asset.)

Output properties

Properties for specifying the output PDF document, operation results, and log files.

Created Document

The location to store the output PDF document. The data type is document.

Optional Output properties

Log Document

The location to store an optional log file. The log file is a plain text file that contains the output from the Distiller service. The log file is not generated under all circumstances. The presence of a log file is not an indication of an error in the conversion because a log file may contain only diagnostic messages. The data type is document.

Exceptions

Distiller exceptions

The Distiller service provides the following exceptions for throwing exception events.

ConversionException

Thrown if a conversion fails because of an underlying exception.

FileFormatNotSupportedException

Thrown when a given file format is not supported.

InvalidParameterException

Thrown when a given parameter is not valid.