Download Interactive DoR

A common use case is to be able to download an interactive DoR with the Adaptive Form data. The downloaded DoR will then be completed using Adobe Acrobat or Adobe Reader.

To accomplish this use case we need to do the following

Generate sample data for the XDP

  • Open the XDP in AEM Forms designer.
  • Click File | Form Properties | Preview
  • Click Generate Preview Data
  • Click Generate
  • Provide meaningful file name such as “form-data.xml”

Generate XSD from the xml data

You can use any of the free online tools to generate XSD from the xml data generated in the previous step.

Create Adaptive Form

Create adaptive form based on the XSD from the previous step. Associate the form to use the client lib “irs”. This client library has the code to make a POST call to the servlet which return the PDF to the calling application
The following code gets triggered when the Download PDF is clicked

$(document).ready(function() {
    $(".downloadpdf").click(function() {
            success: function(guideResultObject) {
                var req = new XMLHttpRequest();

      "POST", "/bin/generateinteractivedor", true);
                req.responseType = "blob";

                var formData = new FormData();

                req.onreadystatechange = function() {

                    if (req.readyState == 4 && req.status == 200) {

                        download(this.response, "report.pdf", "application/pdf");




Create custom servlet

Create a custom servlet that will merge the data with XDP template and return the pdf. The code to accomplish this is listed below. The custom servlet is part of the AEMFormsDocumentServices.core-1.0-SNAPSHOT bundle).

package com.aemformssamples.documentservices.core.servlets;


import javax.servlet.Servlet;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerException;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.dom.DOMSource;
import javax.xml.xpath.XPath;
import javax.xml.xpath.XPathConstants;
import javax.xml.xpath.XPathExpressionException;
import javax.xml.xpath.XPathFactory;


import org.osgi.service.component.annotations.Component;
import org.osgi.service.component.annotations.Reference;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.w3c.dom.Node;

import com.adobe.aemfd.docmanager.Document;
import com.adobe.fd.forms.api.FormsService;
import com.adobe.fd.forms.api.FormsServiceException;
import com.aemformssamples.documentservices.core.DocumentServices;

@Component(service = {
}, property = {

public class GenerateIInteractiveDor extends SlingAllMethodsServlet {
        DocumentServices documentServices;
        FormsService formsService;

        private static final Logger log = LoggerFactory.getLogger(GenerateIInteractiveDor.class);

        protected void doGet(SlingHttpServletRequest request, SlingHttpServletResponse response) {
                doPost(request, response);

        protected void doPost(SlingHttpServletRequest request, SlingHttpServletResponse response) {
                // The xdp name can be passed to this servlet. For now it have been hardocded.

                String xdpName = "f8918-r14e_redo-barcode_3 2.xdp";

                XPathFactory xfact = XPathFactory.newInstance();
                XPath xpath = xfact.newXPath();
                //String dataXml = request.getParameter("formData");
                String dataXml = request.getParameter("dataXml");
                System.out.println("The data xml is " + dataXml);
                org.w3c.dom.Document xmlDataDoc = documentServices.w3cDocumentFromStrng(dataXml);
                System.out.println("The af bound data is " + xmlDataDoc.getElementsByTagName("topmostSubform").getLength());
                try {
                        // get the actual xml data that needs to be merged with the template. This can be made more generic
                        Node res = (Node) xpath.evaluate("afData/afBoundData/topmostSubform", xmlDataDoc, XPathConstants.NODE);
                        StringWriter writer = new StringWriter();
                        Transformer transformer = TransformerFactory.newInstance().newTransformer();
                        transformer.transform(new DOMSource(res), new StreamResult(writer));
                        String xml = writer.toString();
                        xmlDataDoc = documentServices.w3cDocumentFromStrng(xml);
                        Document xmlDataDocument = documentServices.orgw3cDocumentToAEMFDDocument(xmlDataDoc);
                        String xdpTemplatePath = "crx:///content/dam/formsanddocuments";
                        com.adobe.fd.forms.api.PDFFormRenderOptions renderOptions = new com.adobe.fd.forms.api.PDFFormRenderOptions();
                        Document xdpPDF = formsService.renderPDFForm(xdpName, xmlDataDocument, renderOptions);
                        InputStream fileInputStream = xdpPDF.getInputStream();
                        System.out.println("Got xdp PDF" + fileInputStream.available());
                        response.addHeader("Content-Disposition", "attachment; filename=" + xdpName.replace("xdp", "pdf"));
                        response.setContentLength((int) fileInputStream.available());
                        OutputStream responseOutputStream = response.getOutputStream();
                        int bytes;
                        while ((bytes = != -1) {

                } catch (XPathExpressionException e) {

                } catch (TransformerException e) {

                } catch (FormsServiceException e) {

                } catch (IOException e) {




In the sample code, the template name(f8918-r14e_redo-barcode_3 2.xdp) is hardcoded. You can easily pass in the template name to the servlet to make this code generic to work against all templates.

Deploy the sample on your server

To test this on your local server, please follow the following steps:

  1. Download and Install the DevelopingWithServiceUser Bundle
  2. Add the following entry in the Apache Sling Service User Mapper Service
  3. Download and install the custom DocumentServices bundle. This has the servlet to merge the data with the XDP template and stream the pdf back
  4. Import the client library
  5. Import the Adaptive Form
  6. Import the XDP template and schema
  7. Preview Adaptive Form
  8. Fill in few of the form fields
  9. Click Download PDF to get the PDF. You may have to wait a few seconds for the PDF to download

On this page