GitClear allows for custom issue mapping which allows you to define a regular expression pattern that GitClear will use to map commits into issues within your issue tracking software (e.g., Jira). This allows you to see how your tracking estimates compare to the actual time spent by developers in implementing features or fixing bugs.

In order to issue map successfully, your developers will need to include a JIRA issue number in the commit message or title. 

Issue mapping can be found on the organization settings page, under Issue Mapping. 

You will need to submit a regular expression (regex) and an Issue tracker URL. 

Here is an example of a commit by the GitClear development team: 



At the front of the title is [S-480]. This is mapped to JIRA using the regex: so?\-%d 

The regex is accompanied by an Issue tracker URL such as: https://gitclear.atlassian.net/browse/SO-%d

Next to the commit name is a link to take you to the JIRA that is linked to that commit.

Additional Regex Examples: 

PROJECT\-%d

\[SO?%d\]

[ABCD]+\-%d

What can issue mapping be used for?

Issue mapping is used to connect the work being done by your developers to the issue/task in your issue tracking software. By mapping issues you can see the impact required for different projects. You can use that data to forecast for future projects or com[are to the actual time spent. 

If you're not sure how to create a regular expression, feel free to reach out to our support team at support@gitclear.com and we'd be happy to set one up on your behalf.