NOTE: We have only tested these steps with Team Foundation Server versions up to 2013. Please contact support if you need to work with a newer version

There are two aspects to setting up FogBugz-Team Foundation Server integration:

  1. Getting Team Foundation Server (TFS) to transmit changes to FogBugz
  2. Getting FogBugz to provide links to Team System Web Access 2008, the web-based repository browser

Setting up the repository in FogBugz

The starting point for setting up source control integration is to create the repository in FogBugz. To do so, log into FogBugz as an administrator and go to Admin | Source Control. Click Create New Repository. In the resulting dialog, select Team Foundation as the type and give the repository a display name. Click Next.

alt text

In the resulting dialog, download the script necessary to get TFS to transmit changes to FogBugz and choose whether you want FogBugz to provide links to your check-ins. You can change this setting later by clicking the Edit icon next to the repository on the Admin | Source Control page.

Diff and log links

FogBugz can provide links to a site that displays diffs and logs for changes connected to a case. In version 2008, Team Foundation Server itself does not include web-based diff and log viewing capabilities, but Microsoft provides a free application called Team System Web Access 2008 that can display diffs and logs from a web browser. TFS 2010 includes this by default. Once it is installed and working, set the path to it in the New Repository dialog and click OK to complete the setup. For TFS 2010, this should be www.example.org:8080/tfs/web

Note: Team System Web Access 2005 (and therefore Team Foundation Server 2005) will not work with web-based diffs and logs, since it doesn’t allow direct links to logs and diffs.

Getting Team Foundation Server to transmit changes to FogBugz

On your application tier Team Foundation server, run the register-fogbugz.bat script you downloaded above. The script will prompt you to confirm the Team Foundation Server URL; it will then register FogBugz for notifications. After successfully completing this step, you can delete the batch file; it is no longer needed.

Entering case numbers using Team Foundation Server

When you commit a change using Team System, include a single line of the form BugzID: 1234 in the log after the other comments, where 1234 is the case number you want to link. For example:

alt text