PDF Recombiner

PDF Recombiner: Merges pages from multiple unprotected PDF documents into a new PDF document.

This adapter expects an adapter-specific input XML structure which contains all processing information for the PDF documents. The adapter outputs the data of a merged PDF document as a binary data stream or as an XML document.

Properties

Operation

Determines which operation the adapter executes

Possible values: RecombinePDF: Merge pages from different PDF documents into a new PDF document

Parameter

Adapter

Main class of the adapter (do not change!)

Possible values: de.softproject.integration.adapter.pdf.PDFRecombiner: Main class (default)

ReadPartially

Load PDF document into memory in multiple parts (can improve the performance)

Possible values:

yes: Load in several parts one after the other into the working memory
no: Load PDF document(s) into memory in one piece (default)

toXML

Output PDF document Base64-encoded in an XML document

Possible values:

yes: Output XML document
no: Output PDF document as binary data stream (default).

Status values

`1`	The operation was executed successfully.
`-1`	The operation failed due to a technical error.

Input

This adapter expects an adapter-specific input XML structure which contains all processing information for the generated PDF document.

HTML/XML

<pdfRecombiner>
   <PDF name="Declaration of an input document identifier" 
        url="xstore URL of an input PDF document in the repository"/>
   <!-- <PDF name="inputname" 
             encoding="base64">(If input PDF Base64 string)
        </PDF> -->

   <Range pdf="input document identifier" from="start page" 
          to="End page" odd="odd pages (true/false)" 
          even="even pages (true/false)"/>
   <Page pdf="Input document identifier" 
         pageNr="Single page number"/>
   <Empty count="Number of empty pages"/>
   <All pdf="Input document identifier"/>
</pdfRecombiner>

Explanation:

<PDF/>: references one input document.
If an input PDF document is base64 encoded data, the commented out code must be adjusted and commented in instead.
<Range/> defines a page range from start to end page.
<Page/> defines a single page.
<All/> defines all pages of an input PDF document.
<Empty/> defines blank pages in the generated PDF document.

Example

The following input XML document contains information about two PDF documents that are to be merged into a new PDF document with the defined pages and a total of three blank pages.

HTML/XML

<pdfRecombiner>
   <PDF name="input1" url="xstore://Project/Folder/InputPDF1.pdf"/>
   <PDF name="input2" url="xstore://Project/Folder/InputPDF2.pdf"/>
   <!-- <PDF name="inputname" 
             encoding="base64">base_64_encoded_PDF_document</PDF> -->
   
   <Range pdf="input1" from="1" to="10" odd="false" even="true"/>
   <Page pdf="input1" pageNr="1"/>
   <Empty count="2"/>
   <Range pdf="input2" from="5" to="10"/>
   <Empty count="1"/>
   <All pdf="input1"/>
</pdfRecombiner>