Knowledge Base: Integrating with Fogbugz
FogBugz is a task-based bug tracking and project management tool. Each commit in Beanstalk can be associate with a particular case in FogBugz.
Getting started
The setup process is straight forward. Browse to your repository in Beanstalk and find the Setup tab, then click on the Integration navigation link. In the side bar you will see a link for FogBugz. To get started, just click Activate and follow the steps. Keep in mind that steps 2 and 3 are not neccessary for FogBugz On Demand.
How to use the integration
After you have finished the integration process with Beanstalk and FogBugz, associating a case to a commit is simple. In the log message of the commit, simply add:
[BugzID:6375] Updated the project plan
Where 6375 is the case number in FogBugz.
This will add the associated commit and changeset to the case in FogBugz, which then links back to your Beanstalk changeset.
FogBugz 6.0 and On Demand
With the introduction of FogBugz 6.0 and FogBugz On Demand, cases can now be manipulated as well. Here is an example of how you would manipulate a case.
[BugzID:15 review:file1.txt,file2.txt status:resolved] New feature is implemented and tested
The tags above would associate Case 15 with the commit, mark it as resolved, and display the file links for file1.txt and file2.txt for review.
Example FogBugz tags
- BugzID - Associates a case number with the commit. Aliases such as Case: or Bug: are accepted as well.
- status - Set the status of the case, such as status:resolved or status:closed.
- assign - Assigns a case to a user, such as assign:chris (matches closest name, no spaces).
- review - Displays links to specified files in the commit notification (no spaces).
Common integration issues
Checkins: The Checkins data for FogBugz cases will not work on FogBugz On Demand due to setting limitations.