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 AEM forms
.
Retaining legacy appearance of PDF Forms in AEM forms
In AEM forms, 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 AEM forms, 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 AEM forms.
-
In the Components
view, drill down to
FormDataIntegration
>
Active Services
>
FormDataIntegration:1.1
.
-
Right click FormDataIntegration:1.1 and select Edit Service
Configuration.
-
On the Configuration Settings dialog, edit the Appearance
Compatibility Mode option to set the version of Acrobat whose appearance
mode is to be configured.
-
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
.
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
.
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.
|
|
|