XP-Dev.com

XP-Dev.com Documentation - Fogbugz Integration

If you happen to use Fogbugz as your issue/bug tracking tool, you can now get your source control commit changesets linked to your Fogbugz cases and additionally either resolve, close to reassign them to someone else.

Enabling Fogbugz Integration

Configuring XP-Dev.com

  • Head over to your XP-Dev.com project’s Source Control tab
  • Click on Edit Fogbugz Integration Options

  • Turn on Fogbugz Integration Enabled
  • Enter your Fugbugz user, password and installation URL.
    • The user can either be an email address or full name
    • The url can include on standard ports and a full installation path, for .e.g. https://someserver.example.org:3000/path/to/fogbugz
  • Click on Save

  • If all goes well, you should see the Diff URL and Log URL thats needed in the next step so that Fogbugz can link back commits

Configuring Fogbugz

  • Head over to your Fogbugz installation’s Source Control admin page
  • Create a new repository (I just picked a “custom” one)

  • Enter the Diff URL and Log URL as shown in the steps above

Smart Commit Messages for Fogbugz

Whenever you want to reference a Fogbugz case, all you have to do is add a #<case number> in your commit message

For e.g. the commit message #45 add user authentication tokens will link the case number 45 with the commit.

Additionally, you can get XP-Dev.com to perform the following actions as well:

Resolving Cases

To resolve cases, just add the message resolves #case. You can use the word resolve as well.

For e.g. the commit message add user authentication tokens. resolves #45 will link the case number 45 with the commit and resolve the case as well.

Closing Cases

To resolve cases, just add the message closes #case. You can use the word close as well.

For e.g. the commit message add user authentication tokens. closes #45 will link the case number 45 with the commit and close the case as well.

Reassigning Cases

To reassign cases, just add the message #case reassign to john. The words reassign to will act on the case number that it follows. You can use the word assign in replacement of reassign. To specify the user’s full name, just surround it with ". For e.g. resolve #45 reassign to "john smith"

For e.g. the commit message add user authentication tokens. resolves #45 reassign to bob will link the case number 45 with the commit, resolve the case and reassign it to bob.

Real Working Example

I checked in the documentation code into Fogbugz using the commit message 

add fogbugz integration documentation


resolves #11

And the result was:

Disabling Fogbugz Integration

  • Head over to your XP-Dev.com project’s Source Control tab
  • Click on Edit Fogbugz Integration Options
  • Uncheck the box next to Fogbugz Integration Enabled
  • Click on Save