Chapter 1. Burst and Merge PDF Reports

1.1. Burst PDF Reports
1.1.1. Steps to Follow When Bursting a Report
1.1.2. Burst a Sample Report - Invoices-Oct.pdf
1.2. Merge PDF Reports
1.3. Configuration
1.3.1. Advanced Settings

DocumentBurster is splitting the reports with the help of burst tokens. A burst token can be anything which is uniquely identifying the document to be extracted such as the invoice ID, customer number or the email address where the document should be distributed.

A burst token is simply any string that is delimited by curly brackets, { and }. The burst tokens must be inserted into the report pages before feeding the PDF report to DocumentBurster for processing. DocumentBurster screens the document for burst tokens, and whenever it finds a new/different burst token it breaks the document.

An example of such token might be {alfreda.waldback@northridgehealth.org}. If a page from the report needs to be extracted in a separate document then DocumentBurster will be informed about this by using burst tokens. Please take a look at Payslips.pdf report which is available in samples folder. Bursting this report will generate three output files alfreda.waldback@northridgehealth.org, clyde.grew@northridgehealth.org and kyle.butford@northridgehealth.org - for the three distinct employees which are found in the input document.

In DocumentBurster main window select Actions , Merge, Burst and Trace... , Burst

After bursting is finished, in the output folder, following new files will be created

The previous steps will be exemplified when bursting the existing samples/Invoices-Oct.pdf.

  1. Identify the appropriate burst token.

    Since we are bursting an invoice report, the burst token is identified as being Invoice number. Invoice number is uniquely identifying each separate invoice.

  2. Modify the input report to include the curly brackets, { and }, around the previously identified burst token (invoice number).

    The report generation software should properly fill the burst tokens into the pages of the reports. Please check samples/Invoices-Oct.pdf to see how it was modified to include the curly brackets, { and }, around invoice number/burst token report field.

  3. Configure DocumentBurster to generate custom output burst file names.

    By default DocumentBurster is generating the output file names using the $burst_token$.$input_document_extension$ configuration. For example, for the previous burst token/invoice number {0011}, the generated file name will be 0011.pdf.

    The requirement is to customize the output file names to be similar with Invoice-0011.pdf, for the previous burst token/invoice number {0011}.

    In DocumentBurster main window select Actions , Configure , General

    Change the value of the Burst File Name configuration to be Invoice-$burst_token$.$input_document_extension$

    Please see Section 1.3, ?Configuration? for detailed description of DocumentBurster configurations.

  4. Burst the report and check the output files.

    In DocumentBurster main window select Actions , Merge, Burst and Trace... , Burst

    After bursting is finished, in the output folder, following new files will be created

Important

Depending on the business requirements, the report generation software should properly fill the burst tokens into the pages of the reports.

Note

Use a white font color for the burst tokens (or curly brackets, { and }) so that the visual appearance and the layout of the report will not be affected.

Note

Out of the box DocumentBurster supports bursting of PDF and Microsoft Excel reports. If there is a need to burst other report formats such as Word reports, Open Office reports, Microsoft PowerPoint presentations (or any other document type) than DocumentBurster software can be tailored to achieve the bursting and distribution of such report types.

Sometimes, prior to bursting, it might be required to merge few reports together and burst the merged result; or you might as well just want to merge few reports or documents.

DocumentBurster can merge reports through both the command line interface and through the GUI.

In DocumentBurster main window select Actions , Merge, Burst and Trace... , Merge -> Burst

Following properties can be configured in DocumentBurster configuration screen.

Following settings can be configured in regards with merging and bursting of the reports in DocumentBurster™ .

In DocumentBurster main window select Actions , Configure , General

Following advanced settings can be further configured in order to allow greater control over how DocumentBurster works.

In DocumentBurster main window select Actions , Configure , Advanced