You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

What's an Issue Connector?

An Issue Connector is a simple way to connect your repository to your issue tracking system. After setting up an Issue Connector and connecting it to a Repository you've set up, every check in made to that repository will have its commit message parsed by the Issue Connector. The Issue Connector will take the commit message and apply a regex to parse the information the issue connector needs to generate a link. After the information is extracted, the issue connector generates links to your issue tracking system and displays the links in the build those change sets were applicable for.

 

How to Setup an Issue Connector

Issue Connectors are setup in Step 2 of the Project Wizard.

 

 

Click Create to open the dialog for creating a new Issue Connector. When choosing an Issue System, it's not too important to choose the correct one. The options in the Issue System drop down box are purely there to provide default values for the Server URL and Regex. The only fields that affect what the Issue Connector generates are Server URL and Regex.

 

How the Server URL and Regex work

When constructing a Server URL, you need to specify what parts of the commit message will be inserted into a generated URL. Lets assume you have a bug tracking system that requires a project and an id to be able to generate a URL for it. I would setup my Issue Connector like so:

In the above image I have created a Server URL with two substitution fields, {project} and {id}. Doing this means I must construct a Regex that will parse a project and id value out of commit messages. 











 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

  • No labels