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?

ISSUE:

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?



ANSWER:

What is a "TAG"?

A "Tag" is a string of text in a specific format conforming to some rules you set. 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:

<pdfexplode>variables%messageID#e-mails</pdfexplode>

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>messageIdentifier#client@email.com</pdfexplode> OR
<pdfexplode>client@email.com</pdfexplode>

  • 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 4.1.26.97 Nov 2016 or later. 

 

 

Comments Comments
There are no comments for this article. Be the first to post a comment.
Name
Email
Security Code Security Code
Related Articles
How can I set up a MS Word document to use with PDF-eXPLODE?
Viewed 212 times since Fri, Jun 22, 2018
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 1995 times since Wed, Jul 15, 2015
When I click PRINT in my report, PDF-eXPLODE opens up with a Print Options screen and I have to click EXPLODE NOW
Viewed 1107 times since Thu, Dec 4, 2014
How can I explode and email my "tagged" PDF which was generated using another PDF creator?
Viewed 1283 times since Thu, Dec 4, 2014
How can I burst and auto send by email, an Invoice batch with a tag consisting of only an email address where several invoices are tagged with the same email address ?
Viewed 2325 times since Thu, Feb 25, 2016
Can I have one Global PDF-eXPLODE configuration that will work for all Users?
Viewed 1238 times since Thu, Dec 4, 2014
I cannot send emails from PDF-eXPLODE despite getting a success message when running a ’Test Connection’.
Viewed 2075 times since Mon, Oct 5, 2015

Subscribe to Knowledge Base

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