Changing TFS emails to link to Team System Web Access – Part 2

If you click on a hyperlink in an TFS notification mail the following (read-only) web page comes up instead of a nice looking Team System Web Access dialog. Let’s change that!

The days before Team System Web Access

Objective

Make sure all links in the notification mails sent by TFS point to Team System Web Access (TSWA) rather than the integrated read-only web pages from TFS.

There are fourareas to look at:

  1. Work Item notification mails (has already been discussed here)
  2. Build notification mails
  3. Check-in notification mails
  4. Mails sent by Team Explorer (feature of TFS 2008 SP1)

Area 1 is part of a separate blog post, for Area 2 there are currently no equivalent steps (as stated in KB956761). Areas 3 and 4 can be accomplished through the following steps:

Step 1: Specify TSWA Uri using tfsadminutil

Set TSWA uri (as described on MSDN):

tfsadminutil configureconnections /TSWAUri:http://MyTFS:8090/

tfsadminutil configureconnections /TSWAUri

Verify URIs:

tfsadminutil configureconnections

Verify URIs

From now on all your check-in notification mails as well as mails sent via Team Explorer link to TSWA.

Unfortunately there’s one problem if we look at the check-in notification mail we’ll read:

"Details about his check-in were not available when this alert was prepared.
Select the link above to view more details about the check-in."

Before applying the hotfix

Microsoft released a hot fix to correct this behavior.

Step 2: Install hot fix

The hot fix is publically available at: http://code.msdn.microsoft.com/KB957196

Install Hotfix - Step 1 Install Hotfix - Step 2

Install Hotfix - Step 3 Install Hotfix - Step 4

Result

After applying the hot fix

Way better, don’t you think?

Leave a Reply

Your email address will not be published. Required fields are marked *


*

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>