Links for Team System Web Access 2008 Power Tool are enabled only for check-in notification e-mail

Source: Microsoft Support

RAPID PUBLISHING ARTICLES PROVIDE INFORMATION DIRECTLY FROM WITHIN THE MICROSOFT SUPPORT ORGANIZATION. THE INFORMATION CONTAINED HEREIN IS CREATED IN RESPONSE TO EMERGING OR UNIQUE TOPICS, OR IS INTENDED SUPPLEMENT OTHER KNOWLEDGE BASE INFORMATION.

You are using the Team System Web Access (TSWA) 2008 Power Tool and Microsoft Team Foundation Server (TFS) 2008 with Service Pack 1. You have used the ConfigureConnections command of TFSAdminUtil to configure links in notification e-mails to point to artifacts in TSWA instead of in TFS directly, as follows (where http://server:port is the URL to TSWA):

    TFSAdminUtil ConfigureConnections /TswaUri:http://server:port

When you run the TFSAdminUtil as explained in the previous section, the expectation is that it enables links to TSWA in three different types of notification e-mails generated by TFS:

• Check-in notifications
• Build notifications
• Work item change notification

What actually happens is that only check-in notification e-mails are updated to have links to TSWA. Build and work item notification e-mails still link to the old artifact viewers.

Perform the following procedure to manually enable TSWA links in work item notification e-mails. NOTE: there are currently no equivalent steps to enable TSWA links in build notification e-mails.

1. On the application-tier server for Team Foundation, open the following folder:

%ProgramFiles%\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\Services\v1.0\Transforms

2. Back up WorkItemChangedEvent.xsl.
3. In that file, locate the following text: <xsl:value-of select="DisplayUrl" />
4. Replace the text from the previous step with the following text, where "8090" is the port through which you installed Team System Web Access (this assumes that TSWA is installed on the same server as TFS, as the following change will only change the port number and the path, not the server name):

<xsl:value-of select="concat(substring-before(DisplayUrl,':8080/WorkItemTracking/WorkItem.aspx?artifactMoniker='),':8090/wi.aspx?id=',substring-after(DisplayUrl,'artifactMoniker='))" />

5. Save your changes.

For more information on manually enabling TSWA links in work item notifications, see the following BLOG post: http://msmvps.com/blogs/vstsblog/archive/2007/08/31/changing-tfs-email-notifications-to-link-to-team-system-web-access.aspx (http://msmvps.com/blogs/vstsblog/archive/2007/08/31/changing-tfs-email-notifications-to-link-to-team-system-web-access.aspx)

For more information about TSWA links in TFS 2008 SP1, please refer to the "Team System Web Access links" item in the "Other Areas" section in this BLOG post:
http://blogs.msdn.com/bharry/archive/2008/04/28/team-foundation-server-2008-sp1.aspx (http://blogs.msdn.com/bharry/archive/2008/04/28/team-foundation-server-2008-sp1.aspx)

For more information on the TFSAdminUtil ConfigureConnections command, please refer to this web site:
http://msdn.microsoft.com/en-us/library/bb778396.aspx (http://msdn.microsoft.com/en-us/library/bb778396.aspx)

MICROSOFT AND/OR ITS SUPPLIERS MAKE NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY, RELIABILITY OR ACCURACY OF THE INFORMATION CONTAINED IN THE DOCUMENTS AND RELATED GRAPHICS PUBLISHED ON THIS WEBSITE (THE “MATERIALS”) FOR ANY PURPOSE. THE MATERIALS MAY INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS AND MAY BE REVISED AT ANY TIME WITHOUT NOTICE.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, MICROSOFT AND/OR ITS SUPPLIERS DISCLAIM AND EXCLUDE ALL REPRESENTATIONS, WARRANTIES, AND CONDITIONS WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO REPRESENTATIONS, WARRANTIES, OR CONDITIONS OF TITLE, NON INFRINGEMENT, SATISFACTORY CONDITION OR QUALITY, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE MATERIALS.