JiraSvn

We use Jira and it’s one of the best ticketing systems I’ve used. Out of the gate it has some limited integration with subversion that allows you to see comments and changes associated with a defect. The hard part is you have to type the defect id into the comments. This tool is designed to fill that need. Integrated with the command-line checkin or TortoiseSVN this comment dialog allows you to pick one or more defects and can optionally resolve and reassign the issues. It can virtually replace the need to open the Jira web interface.

Getting Started…

 
1. Install the Software

To install visit the project home on goolge code and download the installer. After the installation you can verify the correct registration by going to TortoiseSVN -> Settings -> Issue Tracker Integration. Click the “Add…” button and see if the provider “CSharpTest.Net.SvnPlugin.MyPlugin” appears.

If not, try running %SystemRoot%\Microsoft.NET\Framework\v2.0.50727\RegAsm.exe with the full path to the SvnPlugin.dll file that was installed.

 
2. Enable Jira SOAP

 
3. Configure Subversion

see this aticle for details, but the basics are as follows:
goto TortoiseSVN -> Properties on the root (/trunk) of your repository and add the following properties:

  • bugtraq:append = false
  • bugtraq:label = Defect {PREFIX}-
  • bugtraq:logregex = {Regular express match of defect ids}
  • bugtraq:message = {PREFIX}-%BUGID%
  • bugtraq:number = true
  • bugtraq:url = http://jira:8080/browse/{PREFIX}-%BUGID%

 
Once this is complete, you will need to a new entry specific to this plugin…

  • jira:url = http://jira:8080

 
At this point you can check in with the comment dialog from the command-line svn.exe by setting an environment variable:

SET SVN_EDITOR=C:\Progra~1\CSharpTest.Net\SvnPluginInstall\SvnEditor.exe

 
4. Configure TortoiseSVN

Now that we have all this configured we need to tell TortoiseSVN to use this comment dialog. To do this goto TortoiseSVN -> Settings -> Issue Tracker Integration and click the “Add…” button. Select the provider “CSharpTest.Net.SvnPlugin.MyPlugin”, Enter the base path at which you want to use this editor for checkins (”C:\” works just fine, or set it to your checkout directory). If you did not specify the jira:url svn property, you can provide the root URL to your Jira installation as the “Parameters” entry. I don’t recommend this since it will not work with the command-line version and no other team-mates will benefit from the provisioning.

 
5. Enjoy

You should now be able to check-in/commit and see the button “Jira Issues” just under the bugtraq defect id entry. Clicking this button will present the following comment dialog:

JiraSVN 64-bit installer, Finally!

June 8th, 2010

This plugin should now be functional on 64-bit installations of TortoiseSVN, use the following installation:

http://code.google.com/p/csharptest-net/downloads/detail?name=SvnPluginInstall-x64.msi

Let me know if you have any difficulties.