Form Data Integration

Merges form data into a PDF form. You can import form data into a PDF form and export form data from a PDF form.

In addition, you can import and export interactive PDF form data. An interactive PDF form contains one or more fields for collecting information from a user or displaying custom information. Here are the types of PDF forms:

  • A PDF form created in Acrobat is a PDF document that contains form fields.

  • A PDF form created in Designer is XML-based.

    The data format that you can use for importing and exporting depends on the type of form on which you are performing the operation. This data can be in one of these formats:

  • An XFDF file, which is an XML version of the Acrobat form data format.

  • An XDP file, which is an XML file that contains form field definitions. It may also contain form field data and an embedded PDF file. An XDP file generated by Designer can be used only if it carries an embedded base-64-encoded PDF document.

  • An arbitrary XML file that contains a list of name and value pairs.

For information about using the Form Data Integration service, see Services Reference for Adobe LiveCycle ES4.

    Retaining legacy appearance of PDF Forms in LiveCycle

    In LiveCycle, PDF forms rendered with the assistance of Forms, Output, or Form Data Integration (FDI) services have the appearance that is similar to PDF forms in Acrobat X. However, if you are upgrading from the previous version of LiveCycle, and would like to retain the older appearance of PDF forms, you can set a service-level configuration option for the Forms, Output, and FDI services.

    For the Forms, Output, or FDI services, when the value of this option (Appearance Compatibility Mode) is set to 9, all PDF forms rendered using the service appear in the legacy appearance. Any other value set for this option results in generated PDF forms appearing with the look and feel enabled by LiveCycle.

    1. In the Components view, drill down to FormDataIntegration > Active Services > FormDataIntegration:1.1.

    2. Right click FormDataIntegration:1.1 and select Edit Service Configuration.

    3. On the Configuration Settings dialog, edit the Appearance Compatibility Mode option to set the version of Acrobat whose appearance mode is to be configured.

    4. Click OK to complete the setting.

    exportData operation

    Exports form data from a PDF document. The following table shows data formats that can be exported.

    Form type

    Export format

    Exported Data Format

    Acrobat form

    Auto

    XFDF

    Acrobat form

    XDP

    XFDF (XDP is not valid input for an Acrobat form)

    Acrobat form

    XML

    XFDF (XDP is not valid input for an Acrobat form)

    XML form

    Auto

    XDP

    XML form

    XDP

    XDP

    XML form

    XML

    XML

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

    Input properties

    PDF Document

    A document value that represents the PDF document from which data is exported.

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

    Data Format

    The type of data to export. Possible settings are:

    • Auto XFDF data is exported from an Acrobat form PDF. XDP data is exported from a PDF created in Designer.

    • XDP XDP data is exported from a PDF created in Designer.

    • XmlData XML data is exported from a PDF created in Designer.

    Output properties

    Data Extracted

    The location to store the exported data. The data type is document.

    Exceptions

    This operation can throw an ExportFormDataException exception.

    exportData operation(deprecated)

    Hinweis: This operation is deprecated. Use the exportData operation operation instead

    Exports form data from a PDF document. The following table shows data formats that can be exported from each PDF document type.

    Form type

    Exported Data Format

    Acrobat form

    XFDF

    XML form

    XFA Datasets

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

    Input properties

    PDF Document

    A document value that represents the PDF document from which data is exported.

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

    Output properties

    Data Extracted

    The location to store the exported data. The data type is document.

    Exceptions

    This operation can throw an ExportFormDataException exception.

    importData operation

    Imports XFA or XFDF form data into a PDF document. The following table shows which data formats you can use for each PDF document type.

    Form type

    Import format

    Result

    Acrobat form

    XFDF

    Successful

    Acrobat form

    XFA

    Unsuccessful

    XML form

    XFA

    Successful

    XML form

    XFDF

    Unsuccessful

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

    Input properties

    PDF Document

    A document value that represents the PDF document to which data is to be imported.

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

    Input Data

    A document value that represents XFA or XFDF data to import.

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

    Output properties

    Data Merged PDF

    The location to store the PDF document that contains the imported data. The data type is document.

    Exceptions

    This operation can throw an ImportFormDataExceptionexception.

    Form Data Integration exceptions

    The Form Data Integration service provides the following exception for throwing exception events.

    ImportFormDataException

    Thrown when an error occurs merging form data with a document.

    ExportFormDataException

    Thrown when an error occurs exporting form data from a document.