3000AD Knowledge Base
Home » Categories » Knowledge Base Home » PDF-eXPLODE » Configuring

How do I correctly Tag a document for PDF-eXPLODE processing - what are the rules for a tag?


Incorrect exploded file names or archived folders are only a few of the errors I seem to get in the Log. What are the rules for a Tag?


What is a "TAG"?

A "Tag" is a string of text embedded in the report, in a specific format conforming to some rules you set, which allows the report to communicate with PDF-eXPLODE. PDF-eXPLODE will process the rules based on the order of the Tag text from left to right, provided that the tag conforms to the rules shown below. 

The tag consists of 3 sections, each optional but at least one part must exist on a page between a pair of front and back nodes (<pdfexplode></pdfexplode>)

You insert PDF-eXPLODE tags in your documents to indicate which settings to use when exploding and e-mailing documents. The general format is:


The ‘%’ indicates the end of Variables, whereas as ‘#’ confirms that the word infront of it is a Message ID. The email address must always be at the end of the tag.  Each part is optional. You must have at least one or more of Variables, Message ID or email addresses. If you have nothing between the open and close nodes, then PDF-eXPLODE will convert that page to a 'blanktag.pdf'. 

You insert a "tag" on each page, typically as the first line in the page header, as this tag will automatically be displayed on each page. However there is no restriction to creating a tag in the body of your report or even the Group header or footer; however since Group headers and footers do not always repeat on each page, this means that you may not achieve your desired delivery result.  The tag can be n the following standard format:

<pdfexplode>Message_ID_name#client@email.com</pdfexplode> OR

  • All tags must start ("open") with <pdfexplode> and end ("close") with </pdfexplode> - these are known as "nodes"
  • Open and close tags must match one another in case (i.e. uppercase, lowercase or mixed case).
  • All tags must always include a client identifier, which may be an e-mail address or a filename
  • An optional message identifier, if used, must precede the client identifier and be followed by a pound sign (#)
  • Tags must be formatted with the Arial or Times New Roman font, and the color may be set to White to hide the tag. The tag's font pitch must be NO LESS than 7 pitch.
  • All tags must fit entirely on one line and must never run into other document text or graphics
  • You may include as many tags per page as desired.
  • The total length of a tag excluding the "open"/"close" pdfexplode nodes must be less than 190 characters (Version 2 & 3) and 240 characters (Version 4 ++)

Although the Tag length allowance is 240 characters, there is an overriding Windows rule that requires the (Exploding Path + Tag Length) NOT to exceed 250 characters.  The actual MAX_PATH value is 260 characters, but PDF-eXPLODE uses 10 characters of the 260 to add "_expl.pdf" to the tag name along with a 1 character end of file marker. 

If  your actual tag length is less than 240 characters but you have a long explode path, the full path+filename could exceed 250 characters and the program will "Hang" or you get a Windows error and no further processing will occur.

If that happens, reduce the size of your tag and move the file save path to a shorter exploding folder path. Alternatively, contact 3000AD Systems for a pdfexplode.dll patch (exploding engine) if you are using PDF-eXPLODE Version Nov 2016 or later. 



Comments Comments
There are no comments for this article. Be the first to post a comment.
Security Code Security Code
Related Articles
When a User prints to the Printer Server from Windows 7 workstation, the PDF document is garbled.(missing characters, weird font, large space gaps)
Viewed 4099 times since Thu, Dec 4, 2014
How can I set up a MS Word document to use with PDF-eXPLODE?
Viewed 819 times since Fri, Jun 22, 2018
How can I explode and email my "tagged" PDF which was generated using another PDF creator?
Viewed 1673 times since Thu, Dec 4, 2014
I am evaluating the software and get an error "Illegal Call" when the program is about to explode so effectively the program is not working at all. What can I do?
Viewed 2341 times since Wed, Jul 15, 2015
Can I have one Global PDF-eXPLODE configuration that will work for all Users?
Viewed 1555 times since Thu, Dec 4, 2014
I have intermittent problems running PDF-eXPLODE. How do I configure PDF-eXPLODE for problem free processing?
Viewed 7463 times since Thu, Dec 4, 2014
Each time I send an email in PDF-eXPLODE using MS Outlook MAPI, I get a warning message from Outlook and the program is interrupted and paused waiting for my input.
Viewed 612 times since Fri, Sep 21, 2018
I can’t seem to insert a PDF Coversheet into the front or back of my exploded secured Paystub PDF.
Viewed 2281 times since Thu, Dec 18, 2014
I cannot send emails from PDF-eXPLODE despite getting a success message when running a ’Test Connection’.
Viewed 2600 times since Mon, Oct 5, 2015

Subscribe to Knowledge Base

Get notified when new articles are added to the knowledge base.