Using the Generate PDF service

When converting to PDF and other types of files, you can specify the settings to apply to the resulting document. Here are the parameters you can use to specify these options:

  • PDF settings: This parameter provides the name of the Adobe PDF settings to use for the conversion. The named settings are defined on the Administration Console. The console is pre-configured with several Adobe PDF settings. The names of these settings are locale-specific. On English installations, these names include High Quality Print, PDFA1b 2005 CMYK, and Press Quality.

    If the Input Settings Document parameter provides a value, this parameter is ignored. If this parameter and the Input Settings Document parameter are both null, this operation uses the default file type settings instance that is defined on the LiveCycle server.

  • Security settings: This parameter provides the name of the security settings to use for the conversion. The named settings are defined on the Administration Console. On English installations, the console is pre-configured with only the No Security security settings.

    If the Input Settings Document parameter provides a value, this parameter is ignored. If this parameter and the Input Settings Document parameter are both null, this operation uses the default security settings instance that is defined on the LiveCycle server.

  • File type settings: This parameter provides the name of the file type settings instance that specifies how to convert specific types of file formats. You can create custom versions of these settings by using the Administration Console.

    If the Input Settings Document parameter provides a value, this parameter is ignored. If this parameter and the Input Settings Document parameter are both null, this operation uses the default file type settings instance that is defined on the LiveCycle server.

  • Input Settings Document: An XML file containing conversion settings, including Adobe PDF settings and security settings. The Input Settings Document can contain multiple sets of settings. This operation uses only the default sets.

  • Metadata information to embed in the generated PDF document. Metadata contains information such as the author of the document, the subject, and keywords to associate with the document. Only UTF-8 encoded Adobe Extensible Metadata Platform (XMP) metadata is supported. For information about the format and specifications, see the Extensible Metadata Platform (XMP) page at the Adobe website.

On the PDF Generator web pages in the Administration Console, you can designate one instance of each type of settings as the default. (See LiveCycle Administration Console Help.)

The Generate PDF service supports multi-threaded file conversion using Microsoft Office or OpenOffice. To configure your system to use this feature, click the User Accounts link to provide the user credentials for these applications.(See LiveCycle Administration Console Help.)

For information about developing processes that use the Generate PDF service, see Workbench Help. For information about developing client applications that programmatically interact with this service, see Programming with LiveCycle.

Note: The PDFG Network Printer (IPP printer) is a feature of the Distiller service. You can use PDFG Network Printer to submit PostScript, EPS, or PRN conversion jobs to the Distiller service (see Distiller Service). You cannot use the PDFG Network Printer to submit conversion jobs to any of the Generate PDF services.

// Ethnio survey code removed