Simple steps to configure email testing in SharePoint development environment

Introduction:

Many times when building SharePoint development environment; we need to do testing for emails for workflows, alerts, logging & other stuff. Windows Server 2003 was supporting configuring pop3 email which was amazing; but for some reason; it was removed in Windows Server 2008, in this article I will give you a simple way to configure SharePoint development environment testing emails.

Technology and environment preparation

  • I am using Windows Server 2008 R2 (Windows Server 2008 should work, and windows Server 2012 Should work as well,I would appreciate if somebody confirm this in a comment)
  • I am using SharePoint 2010 (SharePoint 2007 & 2013 versions should work as well, I would appreciate if somebody try it and confirm this in a comments area)
  • I am using a single box development environment (SharePoint + SQL Server + Active Directory + Outlook)

Assumptions:

  • Users who reads this should be familiar with Windows Server, SharePoint and SQL Server basic administration tasks.
  • During this tutorial I will be accessing SharePoint Content Database which is not a good practice to be done in production, (Use this technique on development)

Plan:

  1. Install Mail enable tool (from http://www.mailenable.com/)
  2. Create new mail boxes & make sure that outlook is working.
  3. Configure SharePoint stuff
  4. Do the full test

Solution:

1. Install Mail enable tool (from http://www.mailenable.com/)

– Go to mail enable (http://www.mailenable.com/) and download the Standard Free Edition.

clip_image001

– Start the simple installation process as the following:

– Double Click on the EXE file you will see this form, Keep this as it is.

clip_image002

– Keep this as it is.

clip_image003

– Keep this as it is.

clip_image004

– Keep this as it is.

clip_image005

– Keep this as it is.

clip_image006

– Put what ever domain you like to have (this way my email will be jamil@dev.net).

clip_image007

– Keep it as it is (The application is smart enough to get your default DNS).

clip_image008

– Next…

clip_image009

– I cleared this for simplicity (I like to use outlook more than web access).

clip_image010

Back

2. Create new mail boxes & make sure that outlook is working.

– Go to start menu and type mail…

clip_image001[4]

– Expand the nodes… You may need to Wait for 5 minutes until you see this menu.

clip_image002[4]

– Create new email.

clip_image003[4]

– Configure outlook.

– Open outlook

clip_image004[4]

clip_image005[4]

– Be careful to use the same parameter here.

clip_image006[4]

-Test the email now.

clip_image007[4]

Back

 3. Configure SharePoint stuff

– Assuming that users are already created in active directory; Go to site collection that you want to work on and add those users to it (i.e. into contributor group).

clip_image001[6]

– Then go to SharePoint site collection content database that you want to work on (in my case WSS_Content), find a table called UserInfo.

clip_image002[6]

– Edit the column (tp_Email) for the users that you want to set emails for.

clip_image003[6]

– Go to Central Administration || System Settings || Configure Outgoing Email and type (<Machine Name>) in Outbound SMTP: (Ignoring this step will make alert button missing on document library).

clip_image004[6]

– You are done!

Back

4. Do the Full Test

– Login with Jamil and register your self on a List Alerts to test.

clip_image001[8]

– Keep it as default (any changes).

clip_image002[8]

– You will receive an email telling you that you have registered in this library on outlook.

clip_image003[8]

Back

Conclusion:

This is very important to give the facility to a developer to Test Email Communications (templates, parameters, timing…) and I find this way the most convenient and fast way of doing this job.

Advertisements

About Jamil Haddadin

Sr. SharePoint consultant & Trainer
This entry was posted in SharePoint - How To and tagged . Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s