Available Embedded Commands

 

Two types of command sequences can be used for content-based email sending feature:

·         ##~~ command sequence is used to configure the email sending, but remove the command sequence from the printed document.

 

·         ##** command sequence is used to configure the email sending and print the command sequence on the printed document.

 

Detailed description and example of how to use the command sequences:

 

Command sequence

Description

##~~

Lines starting with these four characters and ending with ~~ are not printed on the output document, but recognized by Print2Email. 

 

For example, if the following string is sent to the driver:  

##~~EmailTo=recipient@domain.com~~

 

As a result, Print2Email will set up the To field of the email to recipient@domain.com, but the whole character sequence (##~~EmailTo=recipient@domain.com~~) will be removed from the printed document.

##**

Lines starting with these four characters and ending with ** are partially printed on the output document. If the string enclosed by the ** marks contains an equation mark, the characters after the equation mark are printed. Otherwise, the whole string between the asterisks is printed.

 

For example, if the following string is printed with the driver:

##**EmailTo=recipient@domain.com**

 

The Print2Email set up the To field of the email to recipient@domain.com, and the following line is printed on the output document file: 

recipient@domain.com

 

 

Available settings

 

List of the available settings which can be specified in the content for email sending:

 

##~~EmailTo=recipient@domain.com~~

Set up the recipient (To) field of the email. Multiple variables can be used, the addresses will be concatenated.

The maximum length is 1024 characters.

Does not contain ~~ and **

##~~EmailCC=recipient2@domain.com~~

Set up the CC (Carbon Copy) field of the email. The recipients specified in the CC will also receive the email as a copy. Multiple variables can be used, the addresses will be concatenated.

The maximum length is 1024 characters.

Does not contain ~~ and **

##~~EmailBCC=recipient3@domain.com, recipient4@domain.com~~

Set up the BCC (Blind Carbon Copy) field of the email. The recipients specified in the BCC will also receive the email as a hidden copy. Multiple variables can be used, the addresses will be concatenated.

The maximum length is 1024 characters.

Does not contain ~~ and **

##~~ES=Content Based Email Subject~~

Set up the Email Subject.

The maximum length is 78 characters.

Does not contain ~~ and **

##~~EB=The body of the email.~~

Set up the Email body.

NOTE: The email body content base tag is limited for number of characters fit on one page. The command close characters (“~~” or “**”) cannot be on the next page of the document.

The maximum length is 2048 characters.

Does not contain ~~ and **

##~~Attachment=c:\temp\test.docx~~

Configure to send an external file as additional attachment that is sent together with an email by giving the full path of the external file.

The maximum length is 254 characters.

Does not contain ~~ and **

File naming

 

##~~Filename=Invoice Number~~

Sets the filename of the generated document. It is possible to specify the filename only, with or without extension, or the full path to the file. If the extension is not specified, the default extension is used according to the file format. E.g:

##~~Filename=Invoice Number~~

 

The filename must be specified on the first page of the document. If the “Send each page as separate email” option is used, the filename must be specified on all pages of the document.

 

The maximum length is 259 characters.

The file name cannot contain ~~ and **

Password protection

 

##~~P1=Password123~~

The printed PDF document will be encrypted with the “Password123” password. Users cannot open the PDF document without the password. Using the P1 variable is the same as enabling the 256-bit AES encryption (Acrobat X or later) encryption and setting the “Password required to open the document” field on the PDF settings window.

The maximum length is 32 characters.

The password cannot contain ~~ or **

##~~P2=Password123~~

The printed PDF document will be encrypted with the “Password123” password. Users can open the PDF document but cannot edit it without the password. Using the P2 variable is the same as enabling the 256-bit AES encryption (Acrobat X or later) encryption and setting the “Password required to edit the document” field on the PDF settings window.

The maximum length is 32 characters.

The password cannot contain ~~ or **

For more information about configuring PDF passwords content base, please refer to Setting PDF Password section.

Custom variables

 

##~~S1=Variable1~~

These custom variables are also can be specified in the printed document’s content, and can be used as in the following example:

 

##~~ ES=Content Based Email Subject for {S1}~~

The maximum length is 2048 characters.

Does not contain ~~ and **

##~~S2=Variable2~~

##~~S3=Variable3~~

##~~S4=Variable4~~

##~~S5=Variable5~~

For more information about custom variables in content base, please refer to Custom variables section.

 

NOTE: If one experiencing issues with using Content Based Email Sending when printing from Adobe Reader, please refer to the following section.