Aloaha PDF Automailer
The Aloaha PDF Suite Automailer was introduced to be able to email fully automatically generated PDF Documents based on commands embedded into the original Document.
To use the Aloaha PDF Suite Automailer Aloaha needs to be in non interactive mode. Print your original document to the monitored printer (default: Wrocklage PDF Printer) or just drop your existing PDF into the dropmailer directory.
There might be cases that the automailer commands should be only enabled if a document is dropped into the
dropmailer folder. In that case please set HKEY_LOCAL_MACHINE\SOFTWARE\Aloaha\pdf\automailer\dropmaileronly to 1.
Enable the Aloaha Automailer
The Aloaha Automailer makes use of the inbuilt Aloaha Scripting Engine. The Aloaha Scripting Engine extracts the content of the first page, parses it and evaluates the embedded commands. You enable the Aloaha Scripting Engine/Automailer by disabling "Interactive" in the system tray icon and enable Automation in the advanced settings submenu.
Command Syntax
It is essential for the Aloaha Scripting Engine that every scripting line is formatted in the same Font, color and size. If this is not given the scripting engine might not find the commands. Obviously you are able to embed the commands in white text on white ground to make them invisible for the recipient.
As an alternative it is also possible to instruct Aloaha to read the commands from an external ASCII file. In that case please use the command Commandfile: <Path to ASCII File>.
The easiest way to learn the engine is to open Notepad and fill in the following example and print it to the Wrocklage PDF Printer:
eMailFrom: “Me” me@aloaha.com
eMailTo: “You” you@aloaha.com
eMailCC: “CC” cc@aloaha.com
Subject: Please find my PDF Document attached
Body: The content of this email is attached as PDF Document
Please note that this sentence will be not visible in the email body but in the PDF Document. The reason is that it does not start with the Keyword Body:
Kind Regards
John Doe
Available Automailer Commands
Per default the following Automailer commands are available. Please note that these are configured in the registry and can be changed/edited. In case you need additional commands please contact our support department.
Mailtoline
Handles the Mail recipients. You can define the recipient(s) of the created PDF Document. Please note that you need one command/per recipient. It is possible to include the display name of the recipient as well. Multiple eMailTo lines per document are supported. Please see below some examples:
eMailTo: Stefan@aloaha.com
eMailTo: “Stefan” Stefan@aloaha.com
eMailTo: “support” <support@aloaha.com>
[SMTP:stefan@aloaha.com]
and
[FAX:0815]
(important if you need to connect Aloaha to native FAX Connectors such as GFI FAXmaker)
Mailccline
The Mailccline defines the “Carbon Copy” recipients of the PDF Document. The default syntax is similar as the eMailTo Command. Please see the example below.
eMailCC: “Stefan” <Stefan@wrocklage.de>
[SMTP:stefan@aloaha.com]
and
[FAX:0815]
(important if you need to connect Aloaha to native FAX Connectors such as GFI FAXmaker)
MailBCCline
The MailBCCline defines the “Blind Carbon Copy” recipients of the PDF Document. The default syntax is similar as the eMailTo Command. Please see the example below.
eMailBCC: “Stefan” <Stefan@wrocklage.de>
Mailfrom
Even the mailfrom has the same syntax as the two commands explained above. The only difference is that only the first Mailfrom command will be evaluated.
eMailFrom: “Me” me@aloaha.com
Subject
Defines the Subject of the email. Only the first subject command will be executed. Please have a look at the example below.
Subject: Please find attached the discussed contract!
Body
The body command defines the TextBody of the email. All Body commands will be added up to one TextBody.
Body: As discussed in our meeting
Body: I am sending you the discussed proposal.
Body: Please note that I signed the PDF Document with my digital certificate.
Attachment
The Attachment command can be used to to add additional files to the outgoing email. Just add the command Attachment: <filepath> on the first page of the document.
HTMLPath
The HTMLPath command can be use to set the HTML Body part of the email. It overrides the Body command.
Usage: HTMLPath: <filepath of HTML Templage>
In case you always need to use the same HTML Template you can defined is permanent in the registry. The Key is HKLM\Software\Aloaha\pdf\HTMLPath
TextPath
The TextPath command is similar to the HTMLPath command. It sets the Text Body part of the email and overrides the Body command.
Usage: TextPath: <filepath of TXT Templage>
In case you always need to use the same Text Template you can defined is permanent in the registry. The Key is HKLM\Software\Aloaha\pdf\TextPath
PDFName
The PDFName commands defines the Filename of the attached PDF Dokument.
Usage: PDFName: <PDF Name>
In case you need to use always the same PDFName it is possible to set the PDFName fixed in the Registry. The Key is HKLM\Software\Aloaha\pdf\PDFName
RemoveFirstPage
This keyword placed on the first PDF page will instruct Aloaha to remove the first page of the PDF document before saving&mailing it.
AppendPDF
This keyword placed on the first PDF page will instruct Aloaha to append the newly created PDF to an existing PDF File.
appendpdf: bla.pdf
or
appendpdf: c:\pdf\hallo.pdf
or
appendpdf: name
DefaultPath
This command redefines the default saving path for the
file Sorting. For example DefaultPath: c:\pdf\
Autoprint
This keyword instructs Aloaha to copy every generated PDF to the
autoprint folder.
UniqueContainerName
The keyword UniqueContainerName instructs Aloaha to sign the PDF. The default signature settings apply. The keyword UniqueContainerName followed by the UniqueContainerName of the Certificate instructs Aloaha to use the specified Certificate for the signature. For example UniqueContainerName: 0 would instruct to sign the PDF with the qualified certificate of the first card reader connected.
Aloaha Automailer Sample.doc(31,23 KB)
Additional Commands
If you need additional commands to connect Aloaha to your existing application such as your Enterprise FAXServer please do not hesitate to discuss that with our support department.
Aloaha FAX Connector
Aloaha makes something impossible possible. Aloaha PDF Suites FAX Connector is able to use Windows XPs or Windows 2003s native Fax Service to send any document via FAX.
The new command is FAX:
Just embed a line like
FAX: 0040545145469
into your document and Aloaha will FAX it!
Find more commands here!
Please note that an evaluation key is required to evaluate the FAX Connector. Contact our support to aquire an evaluation key.
Aloaha Automation White Paper.pdf (645,81 KB)
Aloaha Software / Products / Aloaha PDF Suite Server / Automailer