BooProd.BMail - sending dynamically generated EMails

• Download demo project - 19.6 Kb

Introduction

The purpose of this article is to help you in sending dynamically generated EMails. The EMail body can be set using a text file or an URL, and can contain a special dynamic field, a BMAIL tag, that can be replaced at runtime before sending the EMail. This package will help you send all kinds of EMail like account creation, order, mailing, reports,... everything containing dynamic fields. You can configure your own SMTP server, use notification and add attachments.

How to set the EMail body dynamically?

Note that you can set two kind of EMail body: Text and HTML. The EMail body can be set by different ways. The easiest way is to set the body directly using a string as parameter to setBodyAsText or setBodyAsHTML method. But, when the body is getting long, it's not very easy to maintain a huge amount of text or HTML inside the code. So, a natural way is to use an external file containing the body of the EMail. You can do this using a path as parameter to setBodyFromFile. The last way, but not the least, is to use an URL as parameter to setBodyFromURL. This is very powerful, as the URL can be a simple HTML file on your server, or even an ASP file. For example, you can use different versions of the same EMail for localization purpose.

What is a dynamic field?

A dynamic field is a special tag that will be replaced with an appropriate value just before sending the EMail. So, you can create your EMail template with your favorite HTML editor and insert a special tag, named BMAIL, everywhere you want to use dynamic (runtime depending) values. Then you can use one of the three BMail replacement methods to dynamically replace the HTML code portion of the BMAIL. Note that the BMAIL tag can also be used inside text only EMail.

Background

There's no background needed for using this package but the main problem you can have is with your EMail server. IIS SMTP Virtual server is an Open Relay server and can send your email automatically, but the risk is that the SMTP server of your correspondent will reject the EMail; because your SMTP relay is open or not official (no MX declaration in the DNS zone). So, you can use your own official SMTP account, given by your internet provider.

Installation

Download the ZIP file and extract it on your 'c:\temp' folder. The solution has been made with VS.NET 2003 v7.1.3088, with .NET Framework v1.1.4322 SP1.

See also

You can refer to my article "BooProd.Core - Context Sensitive URL" on treating of context sensitive URL generation. This package will be useful if you need to replace URLs depending on the execution context.

Using the code

Simple use

Here is a simple way to create an EMail :

    BMail vBMail=   new BMail();
    vBMail.From=    "myEMail@xx.com";
    vBMail.To=      "myFriend@yy.com";
    vBMail.Subject= "The subject";
    vBMail.setBodyAsText("Hello, this is an EMail");

If your host can't send EMail directly or is not trusted by your SMTP relay server, authenticate yourself to your SMTP server in the same way you did with Outlook.

    vBMail.SMTPAutenticate= BMail.SMTP_AUTH_BASIC;
    vBMail.SMTPServer=      "smtp.myprovider.com";
    vBMail.SMTPUserName=    "myLogin";
    vBMail.SMTPPassword=    "myPassword";

Then, send the EMail.

    vBMail.send();

Advanced use

The best way to use this package is setting the EMail body dynamically and then replacing parts of the EMail dynamically.

    /// The 'true' parameter indicates that the file is an HTML file

    vBMail.setBodyFromFile("EMailTemplate.html", true);

    /// Replace 3 BMAIL Tag inside the HTML file

    vBMail.replaceFrom("name",   "John");
    vBMail.replaceFrom("number", "1234");
    vBMail.replaceFrom("year",   DateTime.Now.Year.ToString());

Demo Project

A demo application is provided: "BooProd.BMail.Tester". Each step is in a different color.

1. Enter "From" and "To" valid EMail address. Check the "notify" box if you want "From" to be notified by EMail when "To" reads the EMail. Carbon Copy and Blind Carbon Copy is optional. A default subject is provided. Inside the code, you can provide multiple EMail addresses for each entry.
2. Load the EMail body. A default body is provided, containing three BMail tags. These tags will be replaced dynamically with one of the three methods of the combo box. Inside the code, you can set the EMail body with your own, using a text file, an HTML file or a source URL.
3. Enter the SMTP server information, given by your internet provider. If not provided, you must have a local SMTP server on your host (like the one embedded inside IIS). This host must be granted on your SMTP relay server.
4. You can set an attachment file if needed.
5. Now, you can preview the EMail and send it.

Enjoy!

Points of Interest

• First of all, maybe you don't really understand why I am using a dedicated EMail package? My feeling is that when you work within a team, everyone has to use the same development rules. So, here is a way to do this.
• This package can be used as a strong base for any kind of dynamic EMail generation.
• I dedicate this article to BabyKat and Sirteen who can now generate EMail without playing PacMan (private joke).

History

• v1.0 - 2005/01/02

  First version.