...
Suppose you have created a Configuration that builds your product using source code from a Repository. To make this happen you would need to attach that Repository to the Configuration. Once the Repository is attached to the Configuration it will start attaching change sets from that Repository to the Configuration. When the Configuration is next built it will get the relevant change sets from the Repository and attach them to the build. Lets say you've set up a Repository Trigger so every time a check in is made to the Repository the Configuration is built. In this scenario, the build will have the change set that triggered the build. If your companies' policy is to have meaningful commit messages that make references to your issue tracking system, then an Issue Connector can help out. The idea is that when something is checked into your Repository you insert the issue id into the commit message. With an Issue Connector, you can give it a regular expression to parse the issue id. By also providing an Issue Server URL, you can tell the issue connector to take the id it parsed out of the commit message and insert it into the Issuer Server URL and make a hyperlink out of it.
...
Assuming a user commits something to the repository with the message "Fixed annoying deadlock bug, solves issue #29981". The Issue Connector would extract the value "29981" out of the commit message and use the Issuer Issue Server URL to generate the link "http://www.issues.com/issue/29981".
...
Issue Connector Rules and Restrictions
For an Issue Connector to work
...
, the Commit Message Regex must have an
...
id group.
The regular expression used to extract id's takes advantage of named groups. Whenever you use a named group in the regular expression it must have a corresponding tag in the Issue Server URL.
...
Click the "New Issue Connector" button to launch the new issue connector dialog.
The Name of the Issue Connector is used to reference the Issue Connector throughout the Continua UI. The Issue System is a drop down list of the more popular issue tracking systems. The option you select from the Issue System drop down has no effect on the Issue Connector, it simply pre-populates the "Commit Message Regex" and "Issue Server URL" fields. You could just as easily select "Custom" from the drop down and fill out the other fields with your settings. The two important fields are "Commit Message Regex" and "Issue Server URL".
Commit Message Regex
The Commit Message Regex is a regular expression that tells the issue connector to extract certain data out of commit messages and store them in a named group. To properly construct a regular expression to your needs, determine what your repository commit message will contain then write the regex to extract the issue id out of it. When extracting the id, make sure you use regular expression named groups to name that issue id match to the group "id". You may also add other named groups to your regex which can then be used when generating the URL.
Issue Server URL
The Issue Server URL is a
Link an Issue Connector to a Repository
...