Use the Jira integration

Track Jira issues across branches or changesets.

읽는 시간 2분

최근 업데이트: 19일 전

Choose a workflow for your Jira integration to link tickets and transition statuses. Use one of the following working modes for your Jira integration:

Task on branch
Task on changeset

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:
1. 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 branch
```
task004
```
  .
2. Select From task to select an existing Jira task.

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 Jira issues:

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.

기술 자료

Development

User Acquisition

Monetization

산업 분야