Use the JIRA integration
Choose a workflow for your JIRA integration to link tickets and transition statuses.
Use one of the following working modes for your JIRA integration:
You can also transition JIRA statuses.
Find issue information in the JIRA extension panel. You can open the issue in the browser, add a new issue, or delete an issue. If you select the Open issue in browser icon, or double-click on the JIRA task, UVCS opens the associated issue in a browser window. JIRA displays the details of any changes in the linked issue, under the custom field.
Task on branch workflow
Task on branch is the default working mode. Each JIRA task links to a branch in Unity Version Control (UVCS).
Link a branch to an issue
- Create a JIRA issue. JIRA assigns a number to each issue.
- Create a branch that links to JIRA:
- Select Manual to enter a branch name that matches the number of the JIRA issue, preceded by the configured branch prefix. For example, if you configured the branch prefix
task
, and the JIRA issue number is 4, name the branchtask004
. - Select From task to select an existing JIRA task.
- Select Manual to enter a branch name that matches the number of the JIRA issue, preceded by the configured branch prefix. For example, if you configured the branch prefix
If you select the Open issue in browser icon, or double-click on the JIRA task, UVCS opens a browser window with the associated branch issue.
Task on changeset workflow
The task on changeset working mode allows you to link multiple changesets to multiple branches.
Link a changeset to an issue
Use the UVCS desktop application to link changesets to JIRAissues:
- Make the changes in UVCS.
- On the Pending Changes tab, select Show tasks to open the tasks side panel.
- Select the Add new issue (+) icon.
- Select issues from the list of pending tasks, or enter a comma-separated ID list if you can’t find the correct issue.
- Select OK.
To log the checkin information in the related JIRA issue, enter a comment in the Checkin comments field, start the comment with the #
character followed by the issue key. For example, VCS-1: update
.
Transition JIRA statuses
Use changeset comments in Unity Version Control (UVCS) to change the status of a linked issue in the JIRA integration. Your JIRA workflow must allow these transitions.
Configure status transitions
Define your own keyword-status mappings so that if the keyword is in the changeset comment, the issue status transitions to the status mapped to that keyword.
Map keyword-status pairs on Windows
Configure the status transitions in the UVCS desktop application:
- Select the context menu, then select Preferences.
- Select Issue trackers.
- Enter the keyword-status pairs in the Status transitions field.
Map keyword-status pairs on Linux or macOS
- Open the
jira.conf
file. - Add the following line and replace the text in the value parameter with the required keyword-status pairs:
Name=Status transitions;Value=[FIXED]-Ready for QA|[WONTFIX]-Done;Type=Text;IsGlobal=True
Status transition syntax
Use the following format for the keyword-status mapping:
[<KEY>]-<VALUE>|[<KEY>]-<VALUE>
For example, the following keyword-status mapping configures the following transitions:
- If a comment includes the keyword
FIXED
, the issue transitions to the Ready for QA JIRA status. - If a comment includes the keyword
WONTFIX
, the issue transitions to the Done status.