[ Help Index ]

Setting up Source Code Integration 

You can set up source code integration between FogBugz and your source control system in two steps.

If you are using Vault, please read this document.

Step One: Install a "trigger" script in your source control system to notify FogBugz whenever a checkin occurs that is related to a particular bug.

• The easiest way to notify FogBugz is to use an HTTP library to GET a URL of the following form, where bugID is the bug ID number, file is the file that is being checked in, x is the old revision number, and y is the new revision number.

http://fogbugzURL/cvsSubmit.asp?ixBug=bugID&sFile=file&sPrev=x&sNew=y

• You can also notify FogBugz by using a data access library such as ODBC or OLEDB to insert a new record in the table named CVS containing these four values.
• Although you can create your trigger script in any language, we provide sample scripts for how to do it:
• • CVS: perl script
  • Perforce: perl script or VBScript script
  • Subversion: perl or VBScript
  • ClearCase: perl script
• For Visual Source Safe users, you need to run a script that reads the journal file written by VSS when checkins are made.  You can set this script us as a scheduled task.  Be sure to set the journal file for all the appropriate projects in the VSS Admin Console (Tools->Options->General tab).
  • VBScript for Visual Source Safe

Step Two: Configure FogBugz to create hyperlinks from the checkin information to a web page showing the logs or the diffs.

• Log in as an admin in FogBugz, click on Site (top right), and change the two Source Control URLs, as per the instructions on that page.
• For CVS: we suggest installing cvsweb, a cgi script written by Bill Fenner and improved by Henner Zeller, Henrik Nordström, and Ken Coar. It is freely available under the BSD License. You can download it here. This gives you a web interface to logs and diffs.
• For Perforce, you can install perfbrowse, which is available here.
• For Subversion: Use WebSVN. Here are examples for the URLs:
  

  http:// ... /subversion/filedetails.php?rep=0&path=^FILE&rev=0&sc=1

  http:// ... /subversion/diff.php?rep=0&path=^FILE&rev=^R2&sc=1

• Linking back to ClearCase from FogBugz is not currently fully supported, but all you need to do is provide a URL to FogBugz that points to a web-based view of your ClearCase repository. We will be updating this documentation when we have more information on this.

  FogBUGZ Home Page

  Email: fogbugz@fogcreek.com