You are here:

Burst PDF Merge

Oracle Documaker Enterprise Edition supports appending or prepending external PDFs from IPM to Documaker generated burst PDFs. The external PDFs are appended or prepended as a PDF, they are not converted to a graphic prior to being appended or prepended.

Support for appending or prepending external PDFs is limited to burst PDFs. External PDFs cannot be prepended or appended to non-PDF output such as AFP, PCL, etc. When PDF is burst, all external PDFs i.e. appended or pre-pended to a form, are clubbed in the burst PDF of that form. The extract file includes the ID of the document from IPM to be appended or prepended. See the sample extracted file below.

Sample extract.xml file

<Recipient>...
<Form>
<Name></Name>
  <Data>
   <DocumentSetC>
    <FormData>
     <Name></Name>
      <extContent>
        <extPdfContentList>
          <extPdfContInfo>
            <docId>IPM_XXXXX</docId>
            <pos>PREPEND</pos>
            <manFlag>FALSE</manFlag>
            <idx>123</idx>
          </extPdfContInfo>
        </extPdfContentList>
     </extContent>
</Data>
</Form>
...</Recipient>


Content	Description
idx	Indicates the index of the external document. It must be unique within the extract file.
manFlag	Indicates whether it is mandatory to append or prepend the external document referenced by the DocID. If manFlag is set to True and the referenced document isn't found, Status 441 - Presentation Error, is displayed in the Dashboard and Console. If the manFlag is set to False and the referenced document isn't found, Status 999 - Completed is displayed in the Dashboard and Console.
pos	Indicates where to insert external PDF. APPEND: The external PDF is appended to the burst PDF. PREPEND: The external PDF is prepended to the burst PDF.

Oracle Documaker is configured to access the external documents for insertion into generated output. Make sure the OBPPDFBurster is configured to use this feature. Include following configuration in OBPPDFBurster to burst PDF merge:


Context Name	Category	Group Name	Property	Value
LISTENER	OBPPDFBurster	Configuration	phaselistener.pdfstitcher. name	oracle.documaker.ecmconnector. pdfstitcher.IPMPDFStitcher
			phaselistener.pdfstitcher. connection.url	As per your environment, configure IPM URL, for Example: "http://ip-address:port/imaging/ws/"
			phaselistener.pdfstitcher. connection.username	IPM Username, As per your environment
			phaselistener.pdfstitcher. connection.password	IPM Username, As per your environment

Note:

Keep in mind, Oracle Documaker does not validate extract file content.
BurstPDFMerge and AlternateFileToUpload are not designed to work with each other. Therefore, when using BurstPDFMerge, do not use AlternateFileToUpload and vice versa.

Remember, the index (idx) of the external document should be unique within the extract file. The job will not fail if the same index is assigned to multiple external documents within the extract file; the last reference external document will be used for stitching in. There may be instances a duplicate IDX value is intentionally assigned to multiple external documents in the extract file. You may have one external document you want as the ‘default’, but you may want to omit that document if a more specific file is available. Both could be assigned the same IDX value in the extract file, with the expectation that the latter will override the first in sequence. That way they are mutually exclusive. If a specific file is not available, the default file for that sequence is omitted but, you still get default content.