If your source control system is not listed on the FogBugz Source Control Integration page, you can still integrate it with FogBugz. There are two aspects to source control integration:
- Getting your source control system to transmit changes to FogBugz
- Getting FogBugz to provide links to a URL that shows diffs and history logs from your source control system
Getting your source control system to transmit changes to FogBugz
You need to install a “trigger” script in your source control system to notify FogBugz whenever a check-in occurs that is related to a particular bug. You will have to implement this script yourself to integrate with whatever hooks, triggers, or APIs your source control system offers.
The way these scripts work is they send the check-in information via HTTP to a FogBugz ASP page named cvsSubmit.asp, using a URL like:
http://your.fogbugz.server/cvsSubmit.asp?ixBug=bugID&sFile=file&sPrev=x&sNew=y&ixRepository=RepositoryID
Where:
- bugID is the FogBugz bug number
- file is the source file that is being checked in
- x is the previous revision number
- y is the new revision number
- RepositoryID is the ID of the repository you create in FogBugz. You can get this value from the New Repository dialog (see below).
Getting FogBugz to Provide Hyperlinks to Your Source Control Viewer
Log into FogBugz as an administrator and go to Admin -> Source Control. Click Create New Repository. In the resulting dialog, select Other (custom) as the type and give the repository a display name. Click Next.
Under Diff URL, enter the URL of your source control system diff viewer.
In this URL, ^FILE will be replaced with the file name, ^R1 will be replaced with the old version number, and ^R2 will be replaced with the new version number.
Under Log URL, enter the URL of your source control system history viewer.
In this URL, ^FILE will be replaced with a file name for which FogBugz wants to display the history.