Next Action and Email Settings

The Next Action / Email Settings window allows you to

  • Customize the actions performed by pdfMachine after the creation of a PDF
  • Configure the settings that will be used by pdfMachine to send emails

Next Action

These options allow you to customize what actions pdfMachine takes after it creates a PDF.

Next Action Controls what happens after the PDF file has been generated.

Valid Values Action
Launch pdfMachine viewer Default behaviour. Launches the pdfMachine viewer.
No next action Do nothing. No next action takes place. No user interface will be displayed.
Launch default PDF viewer Launch the default PDF file viewer. (usually Acrobat reader)
Execute the command line Execute the command line that is defined by the "Exec Cmd." value. This command is executed after the PDF file has been created.
Launch default mail client with attached PDF Launches the default MAPI email client with the PDF file as an attachment. If there are values in "Email Subject" and "Email Body" they are populated in the email client.
Show 'Save As' window Pops open the standard "Save As" window.
Show Edit window Opens pdfMachine straight into Edit mode.
Launch stamper dialog Pops open the stamper dialog. Once the stamp has been applied, you are left in Edit mode where you can re-position your stamp if required.
OCR then Show 'Save As' Window Performs an OCR on the PDF and then pop the 'Save As' window to save the PDF.
Exec. Command When "NextAction" is equal to "Execute the command line", this is the command that is executed. It may contain a string such as "%s" which will be substituted with the full path of the generated PDF file.
e.g. ExecCmd = c:\winnt\notepad.exe "%s" This would launch the notepad.exe program upon completion of file generation. The notepad program would open the PDF file.

Email Settings

Email Contents Controls how the Email settings for To, Cc, Bcc, Body, Subject and Extra Attach fields are used in the email content.

Valid Values Action
Blank settings The To, Cc, Bcc, Body, Subject and Extra Attach fields will be blank by default.
Note: This is the same as having "Use saved settings in email" unchecked in version 14.86 and earlier
Last used settings Default. The To, Cc, Bcc, Body, Subject and Extra Attach fields will be used from the last Email Settings that were either saved from the Email Config dialog or sent using the Email Config dialog.
Note: This is the same as having "Use saved settings in email" checked in version 14.86 and earlier
Use settings as a template The To, Cc, Bcc, Body, Subject and Extra Attach fields will be used from the last Email Settings that were saved from the Email Config dialog. Changes made in the Email Config dialog while sending will not affect the defaults. The Email Config dialog can be used in this way to store a template for emails.
Confirm Email Attachment Name If checked, the user will be prompted to confirm or change the name of the PDF attachment when the "send" button is pressed.
Auto. Send If checked, and an "Email To:" value is supplied the mail is sent automatically.

Email Config window

This window is shown when you click the Email Settings button.

All Email Fields If set, these fields work with the Email Contents setting to provide default values for the default mail client when it is launched. If the first character is an '@' then the rest of the text is taken to be a filename and the text is read from the file.
e.g. if the "Email Body" value was "@c:\body.txt" then the file c:\body.txt would be read in and this would be placed in the body of the email.

For the TO, CC, BCC address fields, several addresses may appear if the addresses are comma or white space separated. Some email applications require the "SMTP:" prefix on mail addresses to send SMTP style mail.

To The TO address field. e.g.
CC The Carbon Copy address field.
BCC The Blind Carbon Copy address field.
Subject The email subject.
Body The body of the email.  This text may contain html tags if the send method is not Simple MAPI.
Send Method Defines the mail transport.  The method to choose depends upon your environment.

Supported methods are:

Simple MAPI
Uses the Simple MAPI API for sending emails.  Most Windows based email clients support Simple MAPI. Simple MAPI does not work well with Microsoft Outlook. HTML emails are not supported.

Extended MAPI
This is a more sophisticated method which will bypass any security warnings that occur if Outlook is your default MAPI provider. It also supports HTML.
If this method is chosen Outlook must be installed.  A security warning dialog may be displayed upon automated sending.  HTML may be used in the body.

Use this if you wish pdfMachine to communicate directly to a SMTP server bypassing any mail client software. HTML may be used in the body.

SMTP Settings window

This window is shown when you click the SMTP Settings button on the Email Config window. If SMTP is the chosen transport, these settings must be configured:

From The email address that is placed in the "From" field.
Server The domain name of the email server.
Port number may optionally be specified by appending a colon followed by a number.
If no port number is specified, it will default according to the Security setting below, where "TLS" defaults to port 587, "SSL" defaults to port 465, "None" defaults to port 25.
User SMTP email server login username.
Password SMTP email server login password.
Security SMTP email connection encryption security.
None = No encryption, TLS = Transport Layer Security, SSL = Secure Socket Layer.
If no port number is on the server name, the default port number for the security type selected here is used.

Example settings for SMTP via gmail
From :
Server :
User :
Password : ****
Security : TLS
Click here for the gmail settings page.