Email Configuration

 

The Black Ice printer has an email sending capability to send the printed documents in email.

The email sending can be configured in the Control Panel > Devices and Printers > right click on the Black Ice Printer Driver > Printing Preferences > navigate to the Filename Generation tab, check the Send printed document in email in the Email section, and click on the Edit Email settings button to configure the SMTP settings of the email.

On the Email Settings dialog the user can choose whether to use the default email client for email sending, for example, Outlook or Thunderbird, or to connect to an SMTP server.

SMTP Settings

 

If the Use SMTP client option is selected, users can configure any SMTP server for email sending.

 

 

Server - Enter the SMTP server address.

Port - Enter the correct SMTP port for the mail server (25 by default).

Sender Email – The sender email address.

User Name - Username for the email account to be used for sending.

Password - Password for the email account to be used for sending.

Retype password - Re-enter password.

Enable SSL - Enable this checkbox if SSL authentication is required by the mail server.

Send test e-mail - Verifies SMTP settings by sending a test email to the account designated above.


 

Preconfigured Email Settings

 

If the Send emails silently option is enabled, users can preconfigure the email preferences including the Sender name, To, Cc, Bcc, Subject and Body, which results silent email sending without any user interaction. If the user prints to the Black Ice Printer Driver will send the email in the background.

 

 

The Preconfigured Email Settings section provides the option to send emails without user intervention by pre-setting the destination address, destination CC, destination BCC, subject, and body.

 

Send e-mails silently - Enable this checkbox to deliver emails automatically, using the information provided in the subsequent fields:

 

            Sender Name:         the displayed name of the sender

To:                              destination email address

            CC:                             destination CC address

            BCC:                          destination BCC address

            Subject:                    email subject

            Body:                         email body

 

Prompt the user only for email address

 

 

The Prompt the user only for email address options lets the user to predefine the email subject, email body and the email sending method (SMTP, Exchange, or any other method), and when sending an email, a window will appear asking the user to enter the recipient’s email address.

NOTE: To enable the Prompt the user only for email address, the Send emails silently option must be unchecked.

The Prompt the user only for email address configuration is recommended for both Point of Sale system and for restricted environments, since Administrators can preconfigure the email sending during installation, while users only have to click to print and send the email.

Open the email client to select recipients option shows up an email sending window for the user every time when printing a document. On this email sending window, the user can specify the recipients, email subject and email body. This option is useful if the user has to send emails to different recipients every time.

 

After Email Sending

 

If Display Email Sent Successfully Message checkbox is selected, the email confirmation message will display after successful sending the email.

 

If Display Error Message checkbox is selected, error message will display when email sending generates an error response.

 

If the Delete every file, including attachment, after the email is sent option is enabled, the Printer Driver will delete the printed document and attachments after the email is sent successfully.

 


 

 

Logging Settings

 

The Logging Settings section provides information regarding the delivery of email messages.

 

 

 

 

Enable debug logging

 

Enable the Enable debug logging checkbox to save the log file information.

Log directory - The output directory of the log file.

NOTE: Environment variables can also be used to specify the directory.

NOTE: Select a place for the logs where all printer driver users have permission to write.

The Printer Driver creates log files with the name of the date, which means, if the user uses the Email Sending feature on 20th of February 2014, the Printer Driver creates the following log file into the specified directory:

C:\temp\EmailSendingLogs\02_20_2014.log

 

The log file could contain the following messages:

In case of the email has been sent successfully:
11:57:49 AM - SMTP: E-mail has been sent to user1@domain.com, user2@domain.com with attachment: 'PrintedDocument.PDF'

In case of the SMTP host was not found:
12:05:34 PM - SMTP: E-mail sending error: 'The SMTP host was not found.' while sending: 'PrintedDocument.PDF'

In case of network problem, or the SMTP port (25, 465, 587) is blocked, or the Server SMTP port is not configured correctly:
12:07:14 PM - SMTP: E-mail sending error to user1@domain.com, user2@domain.com while sending: 'PrintedDocument.PDF''. Error: Failure sending mail.

 

NOTE: The Black Ice Printer Driver is not checking if the specified destination email addresses exist or not. If the destination email address is not specified correctly, but the SMTP Settings are correct, the Printer Driver tries to send the email and writes ‘E-mail has been sent’ message in the log file.

 

 

Enable Audit logging

 

Log directory - The output directory of the log file.

NOTE: Environment variables can also be used to specify the directory.

NOTE: Select a place for the logs where all printer driver users have permission to write.

When Audit Log creation is enabled, Printer Driver will log every sent email, date, recipients and the username who sent the email. This option is recommended to Administrators to monitor the outgoing emails sent by Printer Driver.

 

The Audit Log contains the following information:

 

Date and Time when the email was sent.

The status of the email sending.

The username who sent the email.

The recipients (To, CC, BCC)

 

Example for the Audit Log:

 

07/20/15 20:01:16,"Sent","John","sales@domain.com"," sales2@domain.com "," sales3@domain.com "

07/20/15 20:02:26,"Sent","John","support@domain.com","info@domain.com",""

07/20/15 20:03:11,"Sent","Tester","developer@domain.com","",""

07/20/15 20:03:16,"Sent","Administrator","sales@domain.com","tester@domain.com ",""

 

 

Limitations:

 

·         The Generate output in memory and the Disable output file options must be disabled on the File Formats tab to use the Send printed document in email feature. To send the printed document in email without saving the file on the computer, please make sure the Delete every file, including attachment, after the email is sent option is enabled in the Email Settings.

 

·         The Email sending feature requires .NET Framework version 4.0 or higher.

 

·         Please make sure the Send printed document in email option is enabled during installation, otherwise, the option will be grayed out and cannot be used. In this case, alternatively, the user can configure the email sending in the Printer Manager, or try uninstalling the printer driver, restarting the system, and reinstalling the Printer Driver.