Wednesday, July 17, 2013

Read Outlook Email Template (.OFT) File & Save Message as MSG Format

This technical tip explains how to read outlook email template File (.OFT). Outlook templates are very useful when you want to send a similar email message again and again. Instead of preparing the message from scratch each time, first prepare the message in Outlook and save it as an Outlook template (OFT). After that, whenever you need to send the message, you can create it from the template, saving time writing the same text in the body or the subject line, setting formatting and so on.
Aspose.Email’s MailMessage class can be used to load and read an Outlook template (OFT) file. Once the Outlook template is loaded in an instance of the MailMessage class, you can update the sender, recipient, body, subject and other properties. After updating the properties:
  • Send the email using the SmtpClient class or
  • Save the message as MSG and do further updates/validation using Microsoft Outlook.
Sample Code for loading outlook email template (.OFT) File, updating the message and saving it in MSG format
[C#]
// Load the Outlook template (OFT) file in MailMessage's instance
MailMessage message = MailMessage.Load("invitation to meeting.oft", MessageFormat.Msg);

// Set the sender and recipients information
string senderDisplayName = "John";
string senderEmailAddress = "john@abc.com";
string recipientDisplayName = "William";
string recipientEmailAddress = "william@xzy.com";

message.Sender = new MailAddress(senderEmailAddress, senderDisplayName);
message.To.Add(new MailAddress(recipientEmailAddress, recipientDisplayName));
message.HtmlBody = message.HtmlBody.Replace("DisplayName", "<b>" + recipientDisplayName + "</b>");

// Set the name, location and time in email body
string meetingLocation = "<u>" + "Hall 1, Convention Center, New York, USA" + "</u>";
string meetingTime = "<u>" + "Monday, June 28, 2010" + "</u>";
message.HtmlBody = message.HtmlBody.Replace("MeetingPlace", meetingLocation);
message.HtmlBody = message.HtmlBody.Replace("MeetingTime", meetingTime);

// Send the email or save as MSG and open in Outlook for further editing
SmtpClient client = new SmtpClient("host", 25, "username", "password");
client.Send(message);

// Save the message in MSG format and open in Office Outlook
MapiMessage msg = MapiMessage.FromMailMessage(message);
msg.SetMessageFlags(MapiMessageFlags.MSGFLAG_UNSENT);
msg.Save("Invitation.msg");
Process.Start("Invitation.msg");


[VB.NET]
' Load the Outlook template (OFT) file in MailMessage's instance
Dim message As MailMessage = MailMessage.Load("invitation to meeting.oft", MessageFormat.Msg)

' Set the sender and recipients information
Dim senderDisplayName As String = "John"
Dim senderEmailAddress As String = "john@abc.com"
Dim recipientDisplayName As String = "William"
Dim recipientEmailAddress As String = "william@xzy.com"

message.Sender = New MailAddress(senderEmailAddress, senderDisplayName)
message.To.Add(New MailAddress(recipientEmailAddress, recipientDisplayName))
message.HtmlBody = message.HtmlBody.Replace("DisplayName", "<b>" & recipientDisplayName & "</b>")

' Set the name, location and time in email body
Dim meetingLocation As String = "<u>" & "Hall 1, Convention Center, New York, USA" & "</u>"
Dim meetingTime As String = "<u>" & "Monday, June 28, 2010" & "</u>"
message.HtmlBody = message.HtmlBody.Replace("MeetingPlace", meetingLocation)
message.HtmlBody = message.HtmlBody.Replace("MeetingTime", meetingTime)

' Send the email or save as MSG and open in Outlook for further editing
Dim client As SmtpClient = New SmtpClient("host", 25, "username", "password")
client.Send(message)

' Save the message in MSG format and open in Office Outlook
Dim msg As MapiMessage = MapiMessage.FromMailMessage(message)
msg.SetMessageFlags(MapiMessageFlags.MSGFLAG_UNSENT)
msg.Save("Invitation.msg")
Process.Start("Invitation.msg")

Wednesday, July 10, 2013

Manage Attachments in Existing & New Email Messages inside Java Apps

This technical tip shows how to manage attachments in email message. There can be certain circumstances when the developers want to access and manipulate the Attachments of an Email Message. Aspose.Email Java API provides the handful of collections and methods to perform a task like Extraction of Attachments. Furthermore, using this API one can Add or Remove Attachments at run time. To demonstrate these features, we will load existing Email Messages from disk and access their Attachment Collection.
Steps to Extract Attachments from an existing Email Message
Please perform the following sequence of steps to save the Attachments from existing Messages:* Create an instance of MailMessage class.* Load the existing Email Message using the load() method exposed by MailMessage class and by specifying the correct MessageFormat.* Create an instance of AttachmentCollection class and fill it with Attachments from the instance of MailMessage using getAttachments() method.* Iterate over the AttachmentCollection.# Create an instance of Attachment class and fill it with indexed value from AttachmentCollection using get() method.# Save the attachment to disk using the save() method exposed by Attachment class.
Adding Attachments to a New Email Message using Aspose.Email for Java 
[Java]
//Create an instance of MailMessage class
MailMessage message = new MailMessage();

//From
message.setFrom(new MailAddress("sender@sender.com"));

//to whom
message.getTo().add(new MailAddress("receiver@gmail.com"));

//Adding 1st attachment
//Create an instance of Attachment class
Attachment attachment;

//Load an attachment
attachment = new Attachment("1.txt");

//Add attachment in instance of MailMessage class
message.getAttachments().add(attachment);

//Add 2nd Attachment
message.getAttachments().add(new Attachment("1.jpg"));

//Add 3rd Attachment
message.getAttachments().add(new Attachment("1.doc"));

//Add 4th Attachment
message.getAttachments().add(new Attachment("1.rar"));

//Add 5th Attachment
message.getAttachments().add(new Attachment("1.pdf"));

//Save message to disc
message.save("output.msg",MessageFormat.getMsg());
Extract Attachments from an existing Email Message
public static void main(String[] args)
{
    // Base folder for reading and writing files
    String strBaseFolder = "D:\\Data\\Aspose\\resources\\";

    //Initialize and Load an existing EML file by specifying the MessageFormat
    MailMessage msg = MailMessage.load(strBaseFolder + "AnEmail.eml", MessageFormat.getEml());

    //Initialize AttachmentCollection object with MailMessage Attachments
    AttachmentCollection attachments =  msg.getAttachments();

    //Iterate over the AttachmentCollection
    for(int index = 0; index < attachments.size(); index++)
    {
        //Initialize Attachment object and Get the indexed Attachment reference
        Attachment attachment = (Attachment) attachments.get(index);
        //Display Attachment Name
        System.out.println(attachment.getName());
        //Save Attachment to disk
        attachment.save(strBaseFolder + "attachment_"+ attachment.getName());
    }
}

Add or Remove Attachments from an existing Email Message
public static void main(String[] args)
{
    // Base folder for reading and writing files
    String strBaseFolder = "D:\\Data\\Aspose\\resources\\";

    //Initialize and Load an existing EML file by specifying the MessageFormat
    MailMessage message = MailMessage.load(strBaseFolder + "AnEmail.eml", MessageFormat.getEml());

    //Initialize AttachmentCollection object with MailMessage Attachments
    AttachmentCollection attachments =  message.getAttachments();
    System.out.println("Attachment Count: " + attachments.size());

    //Check if AttachmentCollection size is greater than 0
    if(attachments.size() > 0)
    {
        //Remove Attachment from index location 0
        attachments.remove(0);
        System.out.println("Attachment Count: " + attachments.size());
    }

    //Add a PDF file as Attachment to the message
    message.addAttachment(new Attachment(strBaseFolder + "Blank.PDF"));
    System.out.println("Attachment Count: " + attachments.size());

    //Save the Email message to disk by specifying the EML MailMessageSaveType
    message.save(strBaseFolder + "message.eml", MailMessageSaveType.getEmlFormat());

}