XP-Dev.com Documentation

FogBugz

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 Repository tab
  • Click on Edit Fogbugz Integration Options

Fogbugz link

  • 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

Edit Fogbugz settings

  • 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

iew Fogbugz settings

Configuring Fogbugz

  • Head over to your Fogbugz installation's Repository admin page
  • Create a new repository (I just picked a "custom" one)

Configuring Fogbugz

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

Configuring Fogbugz

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:

Fogbugz example

Disabling Fogbugz Integration

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

Disabling Fogbugz

Feel free to contact us if you need any assistance.