Click here to Skip to main content
Click here to Skip to main content

Programming With Exchange Server 2007 (EWS) - Part 1

, 28 Aug 2008
Rate this:
Please Sign up or sign in to vote.
This article is the first part of the series on EWS which explores Exchange Web Services

Introduction

Recently I worked on a custom MailClient project. In that, we used EWS API provided by Exchange Server 2007 which is fairly new. During development, we faced many problems. On the Internet, you will get a lot of results but they are really scattered and some of them are missing. Here I want to share my knowledge with all of you and try to provide all the required information and sample code in this series. In every part, I'll take one functionality and try to explore that. Any suggestion will be highly appreciated.

What Is Exchange Server?

Exchange Server is a messaging system that includes Mail Server, e-mail client and GroupWare application. Exchange Server is generally used with Microsoft Outlook and tightly integrated with Active Directory and Instant Messenger.

Messaging System comprises creation, storage, maintenance of different kinds of messages like email, voice mail, fax, images, etc.

Exchange Server API's History

exchange11.JPG

What is Exchange Web Services

EWS (Exchange Web Services) is an Application Programming Interface which can be used by different developers to communicate with Microsoft Exchange Server 2007.

This API is exposed as SOAP (Simple object Access Protocol)- based Web-service, which means a requester must send their request in an XML form using SOAP to EWS contained in an HTTP POST request. EWS itself responds in the same manner using SOAP and XML messages in the HTTP response object. EWS is exposed on a Exchange Client Access Server (CAS) through an ASP.NET 2.0 Web service. This can be represented pictorially as follows:

Exchange22.JPG
Client talking SOAP + XML to EWS

Special Features

  • Efficient access to Outlook PIM objects
  • Notifications and events
  • Synchronization
  • Availability service
  • Autodiscover service
  • E-mail Lifecycle
  • OWA WebParts

How to Use EWS

Most Web services publish a “Contract” of sorts that tell those on the outside what the service can do and how to communicate with it. EWS exposes this contract as a standard Web Services Description Languages (WSDL) document named services.wsdl which resides in the same directory as Web service. One can look into it.

To use it “Add a Web Reference to your project”. It may ask you to supply your credentials, so go ahead if prompted.

Note: Certificate Issues - depending on the nature of the certificate that the Exchange CAS provides to Visual Studio, It might complain that the certificate is untrusted and disable the Add Reference button, so you need to install this certificate.

Now you are ready to use the EWS in your application.

Here, I will take one method exposed by EWS and try to explore it.

Using the Code

How to Send a Mail - Normal Mail

The sample code is like this:

public void SendMessage(
string subject,
string body,
string toEmailAddress)
{
 // Set the version, credentials, and the Client Access server on ExchangeServiceBinding.
    ExchangeServiceBinding esb = new ExchangeServiceBinding();
    esb.Credentials = new NetworkCredential("user2", "password", "domain");
    esb.Url = "https://www.example.com/ews/exchange.asmx";

// Create a CreateItem request object
CreateItemType request = new CreateItemType();

// Setup the request:
// Indicate that we only want to send the message. No copy will be saved.
request.MessageDisposition = MessageDispositionType.SendOnly;
request.MessageDispositionSpecified = true;

// Create a message object and set its properties
MessageType message = new MessageType();
message.Subject = subject;
message.Body = new BodyType();
message.Body.BodyType1 = BodyTypeType.Text;
message.Body.Value = body;
message.ToRecipients = new EmailAddressType[1];
message.ToRecipients[0] = new EmailAddressType();
message.ToRecipients[0].EmailAddress = toEmailAddress;
message.ToRecipients[0].RoutingType = "SMTP"; 

//There are some more properties in MessageType object 
//you can set all according to your requirement
// Construct the array of items to send
request.Items = new NonEmptyArrayOfAllItemsType();
request.Items.Items = new ItemType[1];
request.Items.Items[0] = message;

// Call the CreateItem EWS method.
CreateItemResponseType response = esb.CreateItem(request);
this.ThrowOnError("SendMessage", response.ResponseMessages.Items[0]);
}

How to Send a Mail with Attachment

To send mail with attachment:

  1. Create a MessageType object using CreateItem
  2. Add the attachments using CreateItem
  3. Send the message using SendItem

Creating a messageType Object using CreateItem

public ItemIdType CreateMessage(
string subject,
string body,
string toEmailAddress)
{
 // Set the version, credentials, and the Client Access server on ExchangeServiceBinding.
    ExchangeServiceBinding esb = new ExchangeServiceBinding();
    esb.Credentials = new NetworkCredential("user2", "password", "domain");
    esb.Url = https://www.example.com/ews/exchange.asmx;

// Create a CreateItem request object
CreateItemType request = new CreateItemType();

// Setup the request:
// Indicate that we only want to send the message. No copy will be saved.
request.MessageDisposition = MessageDispositionType.SaveOnly;
request.MessageDispositionSpecified = true;

// Create a message object and set its properties
MessageType message = new MessageType();
message.Subject = subject;
message.Body = new BodyType();
message.Body.BodyType1 = BodyTypeType.Text;
message.Body.Value = body;

message.ToRecipients = new EmailAddressType[1];
message.ToRecipients[0] = new EmailAddressType();
message.ToRecipients[0].EmailAddress = toEmailAddress;
message.ToRecipients[0].RoutingType = "SMTP";

//Note: Same you can set CC and BCC Recipients

// Construct the array of items to send
request.Items = new NonEmptyArrayOfAllItemsType();
request.Items.Items = new ItemType[1];
request.Items.Items[0] = message;

// Call the CreateItem EWS method.
CreateItemResponseType response = esb.CreateItem(request);
this.ThrowOnError("SendMessage", response.ResponseMessages.Items[0]);
}   

Adding the Attachments

public ItemIdType CreateAttachment(string name,string FilePath, ItemIdType p_signalId)
{
 ExchangeServiceBinding esb = new ExchangeServiceBinding();
    esb.Credentials = new NetworkCredential("user2", "password", "domain");
    esb.Url = "https://www.example.com/ews/exchange.asmx";

FileAttachmentType fileAttachment = null;

//Create add attachment request.
CreateAttachmentType attachementRequest = new CreateAttachmentType();

attachementRequest.ParentItemId = p_signalId;
attachementRequest.Attachments = new AttachmentType[intAttachmentsCount];

fileAttachment = new FileAttachmentType();
MessageBDO.AttachmentsDTRow drowAttachment
= (MessageBDO.AttachmentsDTRow)p_signal.AttachmentsDT.Rows[intIndex];

fileAttachment.Name =name;
fileAttachment.ContentType = "text/plain";
fileAttachment.Content = System.IO.File.ReadAllBytes(FilePath);
attachementRequest.Attachments[intIndex] = fileAttachment;

ItemIdType attachmentItemId = new ItemIdType();
CreateAttachmentResponseType response = 
	(CreateAttachmentResponseType)_esb.CreateAttachment(attachementRequest );
if (response.ResponseMessages.Items[0].ResponseClass == ResponseClassType.Success)
{
AttachmentIdType attachmentId = ((AttachmentInfoResponseMessageType)
	response.ResponseMessages.Items[0]).Attachments[0].AttachmentId;
attachmentItemId.ChangeKey = attachmentId.RootItemChangeKey.ToString();
attachmentItemId.Id = attachmentId.RootItemId.ToString();
}
return attachmentItemId;
}

Now Sending the Mail

 //Here the itemID is returned by the CreateMessage Function         
public bool SendMessage(ItemIdType p_itemId)
 {
 bool blnResult = false;
 SendItemType siSendItem = new SendItemType();
 siSendItem.ItemIds = new BaseItemIdType[1];
 siSendItem.SavedItemFolderId = new TargetFolderIdType();
 DistinguishedFolderIdType siSentItemsFolder = new DistinguishedFolderIdType();
 siSentItemsFolder.Id = DistinguishedFolderIdNameType.sentitems;
 siSendItem.SavedItemFolderId.Item = siSentItemsFolder;
 siSendItem.SaveItemToFolder = true;
 
 siSendItem.ItemIds[0] = (BaseItemIdType)p_itemId;
 SendItemResponseType srSendItemResponseMessage = _esb.SendItem(siSendItem);
 if (srSendItemResponseMessage.ResponseMessages.Items[0].ResponseClass == 
	ResponseClassType.Success)
 {
 blnResult = true;
 }
 else
 {
 blnResult = false;
 }
 return blnResult;
 }  

Reference

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Brij
Software Developer (Senior)
India India
Brij is a 3-times Microsoft MVP in ASP.NET/IIS Category and a passionate .NET developer. More than 6 years of experience in IT field, currently serving a MNC as a Tech Lead/Architect.
 
He is a very passionate .NET developer and have expertise over Web technologies like ASP.NET 2.0/3.5/4.0, jQuery, JSON, Javascript, IIS and related technologies. He is also a Exchange Server (EWS) Specialist. He has great experience in design patterns and N-Tier Architecture.
 
He is also certified as Microsoft Certified Technologies Specialist-ASP.NET and Microsoft Certified Technologies Specialist-WCF in .NET 4.0. He has also received several awards at various forums and his various articles got listed as "Article of the day" at ASP.NET Microsoft Official Website www.asp.net.
 
He has done MCA from NIT Durgapur and completed his graduation from Lucknow University.
 
Learning new technologies and sharing knowledge excites him most. Blogging, solving problems at various forums, helping people, keeps him busy entire day.


Visit his Blog: Brij's arena of .NET
 
Area of Expertise :
C#, ASP.NET 2.0,3.5,4.0, AJAX, JQuery, JSON, XML, XSLT, ADO.Net, WCF, Active Directory, Exchange Server 2007 (EWS), Java script, Web Services ,Win services, DotnetNuke, WSS 3.0,Sharepoint Designer, SQL Server 2000/2005/2008
Follow on   Twitter

Comments and Discussions

 
AnswerRe: Can the EWS interface be exposed in vb.net PinmemberBrij3-May-09 23:40 
AnswerRe: Can the EWS interface be exposed in vb.net PinmemberNewCoder55519-Jan-10 12:07 
GeneralRe: Can the EWS interface be exposed in vb.net PinmemberNewCoder55519-Jan-10 12:08 
QuestionProblems facing in programming Exchange 2007 using EWS PinmemberSamta_29-Apr-09 2:09 
Hi,
I have created a Dynamic Web project using Rational Application developer and have created a web client by providing the exchange2007 WSDL URL. This generated lots of files and "ExchangeServiceBindingStub.java" is one of them.
I am unable to follow the steps that you have mentioned in your article :
1. I dont have ExchangeServiceBinding class instead I have ExchangeServiceBindingStub.
2. Dont have anything called "credentials" in ExchangeServiceBindingStub.java
3. The definition of "FindItem" method in my case is -
public void findItem(javax.xml.soap.SOAPElement request, com.microsoft.schemas.ExchangeImpersonationType impersonation, com.microsoft.schemas.SerializedSecurityContextType s2SAuth, java.lang.String mailboxCulture, com.microsoft.schemas.holders.FindItemResponseTypeHolder findItemResult, com.microsoft.schemas.holders.ServerVersionInfoHolder serverVersion)
 
unlike the one that you are using which just takes one input parameter "request". Same is the case in all the other methods also.
 
I dont understand these differences and not sure how do I invoke the call to Exchange 2007 in this situation.
Would be thankful if you can throw some light on my concerns and suggest on how to move ahead.
 
thanks
Samta
AnswerRe: Problems facing in programming Exchange 2007 using EWS PinmemberBrij3-May-09 23:24 
QuestionAdmin acces PinmemberWired.Enterprises8-Apr-09 8:55 
QuestionCan't send to addresses that don't end in .com eg ian@xtra.co.nz Pinmemberparkerig16-Mar-09 15:25 
AnswerRe: Can't send to addresses that don't end in .com eg ian@xtra.co.nz PinmemberBrij8-Apr-09 23:41 
GeneralExchange Server 2003 PinmemberShahbaz Yousuf8-Mar-09 3:19 
GeneralRe: Exchange Server 2003 PinmemberBrij8-Apr-09 23:30 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.140814.1 | Last Updated 29 Aug 2008
Article Copyright 2008 by Brij
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid