Converting Strings into Links to Issues
When enabling issue tracker integration in addition to general settings, you need to specify which strings are to be recognized as references to issues in your tracker.
For Bugzilla, you need to specify the Issue Id Pattern: a Java Regular Expression pattern to find the issue ID in the text. The matched text (or the first group if there are groups defined) is used as the issue number. The most common case seems to be
#(\d+) - this will extract 1234 as issue ID from text "Fix for #1234".
If the username and password are specified, you need to have Bugzilla XML-RPC interface switched on. This is not required if you use anonymous access to Bugzilla without the username and password.
There are several known issues in Bugzilla regarding XMLs generated for the issues, which makes it hard to communicate with it. However this can usually be fixed by tweaking the Bugzilla configuration.
- If you see a path/to/bugzilla.dtd not found error, this means that the issue XML contains the relative path to the
bugzilla.dtdfile, and not the URL. To fix that, set the server URL in Bugzilla.
- Sometimes you may see a
SAXParseExceptionsaying that Open quote is expected for attribute “type_id” associated with an element type “flag”. This happens because the generated XML does not correspond to the bundled
bugzilla.dtd. To fix it, make the
#IMPLIED(optional) in the bugzilla.dtd file. The issue and the workaround are described in detail here.