DocumentBurster™ in 5 Minutes

Abstract

This document will help you start using DocumentBurster™ in few minutes.

1. Introduction
1.1. Convention - Path Separator
1.2. We Need Feedback!
2. Download DocumentBurster
3. DocumentBurster requires Java runtime (JRE) as a pre-requisite
3.1. Java
4. Burst a Sample Report - Payslips.pdf
5. What's Next?
5.1. Common Report Delivery Scenarios
5.2. Advanced Report Delivery Scenarios
6. Troubleshooting
7. Quick & Professional Support

1.  Introduction

This quick start document will demonstrate how to use DocumentBurster™ software.

For details on how to install DocumentBurster™ Server you can read here https://www.pdfburst.com/docs/html/userguide/chapter.server.html .

This document uses slash character (/) to display directory and file components of a path.

Microsoft Windows can accept either the backslash (\) or slash (/) characters to separate directory and file components of a path, while the Microsoft convention is to use a backslash (\). Since DocumentBurster™ is intended to work on multiple operating systems (e.g. Windows, Linux), the convention for this manual is to use the slash character (/) to display the components of a path.

If you find a typographical error in this manual, or if you have thought of a way to make this manual better, we would love to hear from you!

If you have a suggestion for improving the documentation, try to be as specific as possible when describing it. If you have found an error, please include the section number and some of the surrounding text so we can find it easily.

Email address -

2.  Download DocumentBurster™

First step is to download documentburster.zip file and extract it to a drive like C:/

https://s3.amazonaws.com/documentburster/newest/documentburster.zip

Once the zip file is extracted, a new folder will be available and will contain all DocumentBurster™ program files.

E.g. - C:/DocumentBurster-5.2.8

3. DocumentBurster requires Java runtime (JRE) as a pre-requisite

In order to use DocumentBurster™ Java runtime (version 1.8 or higher) should be installed on your computer.

These days many systems already have Java runtime installed. If yours doesn’t, you can download & install the software from

http://www.java.com/en/download/index.jsp

Check Java version

In Windows Command Prompt type java –version and this command will return the version of Java which is installed on the machine. It should be greater or equal to version 1.8

It is OK - Java is installed

Important

Following is required only if the java –version command doesn't return a correct Java version. Sometimes, on Windows, the java –version command doesn't return a correct Java version, even after the latest java is installed. This is happening because the Windows %PATH% system environment variable doesn't reflect the location to Java's bin folder.

Solution - Windows 2000/XP/Vista/Windows 7.

  • Open the Control Panel - > System properties (WinKey + Pause) dialog. Select the Advanced tab, and then Environment Variables.
  • Make sure that the Windows %PATH% system environment variable is updated to include the path to Java's bin folder, e.g. C:/Program Files/Java/jre8/bin or similar should be in the %PATH% system environment variable. Be sure to omit any quotation marks around the path even if it contains spaces.
  • Run again the java –version command. It should return a Java version 1.8+ installation.

4.  Burst a Sample Report - Payslips.pdf

DocumentBurster™ is coming with a three pages Payslips.pdf document which is located in the samples folder. Bursting this report will generate three output files

for the three distinct employees which are found in the input report.

Please check the samples/Payslips.pdf report to see how the burst tokens are defined like email addresses delimited by curly brackets, { and } .

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

Once bursting is finished, in the output folder, following files are generated

DocumentBurster™ generated a different file for each employee which was found in the sample Payslips.pdf report. The software can be configured to email the individual pay slips to the corresponding employees.

Similarly DocumentBurster™ can be configured to process other report types such as invoices, statements, purchase orders, commissions reports or dunning letters in order to distribute relevant parts to each of your clients, subscribers, partners or vendors.

Important

Following is required only if the behavior described below is observed.

When I select the sample file to burst, and click "burst" it asks if I want to post a new job. When I click to go ahead, it appears to do the job, and then confirms that the job was done. Only thing is, no files appear in the output folder.

Sometimes the Windows %PATH% system environment variable doesn't reflect the location to Java's bin folder and, as a result, the program does not work and the above behavior is observed.

Solution - Windows 2000/XP/Vista/Windows 7.

5. What's Next?

We hope that this quick overview has piqued your interest in DocumentBurster™ . Note that this is a very truncated quick start document. Now you are ready for more comprehensive details concerning the actions you have just performed.

6.  Troubleshooting

If required, there is an User Guide chapter providing troubleshooting information Appendix E. Troubleshooting available at the end of DocumentBurster™ User Guide.

7. Quick & Professional Support

If you have any questions that aren't answered here, feel free to contact us -