Creating PDF Documents with Submitted XML Data

Include project files

Include client JAR files, such as adobe-forms-client.jar, adobe-output-client.jar, and adobe-contentservices-client.jar in your Java project’s class path.

Create Forms, Output, and Document Management objects

• Create a ServiceClientFactory object that contains connection properties.
• Create a FormsServiceClient object by using its constructor and passing the ServiceClientFactory object.
• Create an OutputClient object by using its constructor and passing the ServiceClientFactory object.
• Create a DocumentManagementServiceClientImpl object by using its constructor and passing the ServiceClientFactory object.

Retrieve form data using the Forms service

• Invoke the FormsServiceClient object’s processFormSubmission method and pass the following values:

  • The com.adobe.idp.Document object that contains the form data.
  • A string value that specifies environment variables, including all relevant HTTP headers. Specify the content type to handle by specifying one or more values for the CONTENT_TYPE environment variable. For example, to handle XML data, specify the following string value for this parameter: CONTENT_TYPE=text/xml.
  • A string value that specifies the HTTP_USER_AGENT header value, such as Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
  • A RenderOptionsSpec object that stores run-time options.

  The processFormSubmission method returns a FormsResult object containing the results of the form submission.

• Determine whether the Forms service is finished processing the form data by invoking the FormsResult object’s getAction method. If this method returns the value 0, the data is ready to be processed.

• Retrieve form data by creating a com.adobe.idp.Document object by invoking the FormsResult object’s getOutputContent method. (This object contains form data that can be sent to the Output service.)

• Create a java.io.InputStream object by invoking the java.io.DataInputStream constructor and passing the com.adobe.idp.Document object.

• Create an org.w3c.dom.DocumentBuilderFactory object by calling the static org.w3c.dom.DocumentBuilderFactory object’s newInstance method.

• Create an org.w3c.dom.DocumentBuilder object by invoking the org.w3c.dom.DocumentBuilderFactory object’s newDocumentBuilder method.

• Create an org.w3c.dom.Document object by invoking the org.w3c.dom.DocumentBuilder object’s parse method and passing the java.io.InputStream object.

• Retrieve the value of each node within the XML document. One way to accomplish this task is to create a custom method that accepts two parameters: the org.w3c.dom.Document object and the name of the node whose value you want to retrieve. This method returns a string value representing the value of the node. In the code example that follows this process, this custom method is called getNodeText. The body of this method is shown.

Create a non-interactive PDF document using the Output service.

Create a PDF document by invoking the OutputClient object’s generatePDFOutput method and passing the following values:

• A TransformationFormat enum value. To generate a PDF document, specify TransformationFormat.PDF.
• A string value that specifies the name of the form design. Ensure that the form design is compatible with the form data retrieved from the Forms service.
• A string value that specifies the content root where the form design is located.
• A PDFOutputOptionsSpec object that contains PDF run-time options.
• A RenderOptionsSpec object that contains rendering run-time options.
• The com.adobe.idp.Document object that contains the XML data source that contains data to merge with the form design. Ensure that this object was returned by the FormsResult object’s getOutputContent method.
• The generatePDFOutput method returns an OutputResult object that contains the results of the operation.
• Retrieve the non-interactive PDF document by invoking the OutputResult object’s getGeneratedDoc method. This method returns a com.adobe.idp.Document instance that represents the non-interactive PDF document.

Store the PDF form in Content Services (deprecated)using the Document Management service

Add the content by invoking the DocumentManagementServiceClientImpl object’s storeContent method and passing the following values:

• A string value that specifies the store where the content is added. The default store is SpacesStore. This value is a mandatory parameter.
• A string value that specifies the fully qualified path of the space where the content is added (for example, /Company Home/Test Directory). This value is a mandatory parameter.
• The node name that represents the new content (for example, MortgageForm.pdf). This value is a mandatory parameter.
• A string value that specifies the node type. To add new content, such as a PDF file, specify {https://www.alfresco.org/model/content/1.0}content. This value is a mandatory parameter.
• A com.adobe.idp.Document object that represents the content. This value is a mandatory parameter.
• A string value that specifies the encoding value (for example, UTF-8). This value is a mandatory parameter.
• An UpdateVersionType enumeration value that specifies how to handle version information (for example, UpdateVersionType.INCREMENT_MAJOR_VERSION to increment the content version. ) This value is a mandatory parameter.
• A java.util.List instance that specifies aspects related to the content. This value is an optional parameter and you can specify null.
• A java.util.Map object that stores content attributes.

The storeContent method returns a CRCResult object that describes the content. Using a CRCResult object, you can, for example, obtain the content’s unique identifier value. To perform this task, invoke the CRCResult object’s getNodeUuid method.