Changing TFS email notifications to link to Team System Web Access
Thanks to this MSDN Forums post I was able to change the link included in every TFS notification e-mail to point to TSWA instead of the project portal.
Here’s the full story:
When using project alerts to get notified about work item changes you get an email containing a link to the project portal:
If you follow the link you might get a bit dissapointed when looking at this very basic work item details page:
Since Team System Web Access is now avaible from Microsoft free of charge we can change the link in the template for all notification messages to point to the new TSWA.
Changing the e-mail template
- On the TFS app tier open the folder:
%ProgramFiles%\Microsoft Visual Studio 2005 Team Foundation Server\Web Services\Services\v1.0\Transforms
- Create a backup of the file WorkItemChangedEvent.xsl, which we will be editing in the next step.
- Replace the text:
<xsl:value-of select="DisplayUrl" />
with:
<xsl:value-of select="concat(substring-before(DisplayUrl,':8080/WorkItemTracking/WorkItem.aspx?artifactMoniker='),':8090/wi.aspx?id=',substring-after(DisplayUrl,'artifactMoniker='))" />
The bold printed 8090 is the port where you installed TSWA at.
- Save the file and you are done.
If you now get a new notification e-mail and click on the link you’ll see the following much nicer work item details form provided by TSWA:
Note: Be aware that you either need to use Windows authentication with TSWA to make this work or you need to be already logged in and the session must be still alive.
I published a 2nd part: Changing TFS emails to link to Team System Web Access – Part 2