Jira integration issue management

Integrating issue management with Jira requires you to configure Jira and enable the Jira integration in WVS. After you configure and enable the integration, you can reference and close Jira issues by mentioning the Jira ID in WVS commits and merge requests.

The Jira integration requires to you format any Jira issue IDs in uppercase.

Reference Jira issues

With this integration, you can cross-reference Jira issues while you work in WVS issues and merge requests. Mention a Jira issue in a WVS issue, merge request, or comment, and WVS adds a formatted comment to the Jira issue. The comment links back to your work in WVS.

For example, this commit references the Jira issue GIT-1:

git commit -m "GIT-1 this is a test commit"

WVS adds a reference to the Issue Links section of Jira issue GIT-1:

WVS also adds a comment to the issue, and uses this format:

  • USER: The name of the user who mentioned the issue, linked to their WVS user profile.
  • COMMENTLINK: A link to where the Jira issue was mentioned.
  • RESOURCE_NAME: The type of resource, such as a commit or merge request, which referenced the issue.
  • PROJECT_NAME: The WVS project name.
  • ENTITY_TITLE: The title of the merge request, or the first line of the commit.

You can disable comments on issues.

Require associated Jira issue for merge requests to be merged

You can prevent merge requests from being merged if they do not refer to a Jira issue. To enforce this:

  1. Navigate to Project Settings > General page.
  2. Expand the Merge requests section.
  3. Under Merge checks, select the Require an associated issue from Jira checkbox.
  4. Select Save for the changes to take effect.

After you enable this feature, a merge request that doesn’t reference an associated Jira issue can’t be merged. The merge request displays the message To merge, a Jira issue key must be mentioned in the title or description.

Close Jira issues in WVS

If you have configured WVS transition IDs, you can close a Jira issue directly from WVS. Use a trigger word followed by a Jira issue ID in a commit or merge request. When you push a commit containing a trigger word and Jira issue ID, WVS:

  1. Comments in the mentioned Jira issue.
  2. Closes the Jira issue. If the Jira issue has a resolution, it isn’t transitioned.

For example, use any of these trigger words to close the Jira issue PROJECT-1:

  • Resolves PROJECT-1
  • Closes PROJECT-1
  • Fixes PROJECT-1

The commit or merge request must target your project’s default branch. You can change your project’s default branch under project settings.

Use case for closing issues

Consider this example:

  1. A user creates Jira issue PROJECT-7 to request a new feature.
  2. You create a merge request in WVS to build the requested feature.
  3. In the merge request, you add the issue closing trigger Closes PROJECT-7.
  4. When the merge request is merged:
    • WVS closes the Jira issue for you:
    • WVS adds a formatted comment to Jira, linking back to the commit that resolved the issue. You can disable comments.

Automatic issue transitions

When you configure automatic issue transitions, you can transition a referenced Jira issue to the next available status with a category of Done. To configure this setting:

  1. Refer to the Configure WVS instructions.
  2. Select the Enable Jira transitions checkbox.
  3. Select the Move to Done option.

Custom issue transitions

For advanced workflows, you can specify custom Jira transition IDs:

  1. Use the method based on your Jira subscription status:
    • (For users of Jira Cloud) Obtain your transition IDs by editing a workflow in the Text view. The transition IDs display in the Transitions column.
    • (For users of Jira Server) Obtain your transition IDs in one of these ways:
      • By using the API, with a request like https://yourcompany.atlassian.net/rest/api/2/issue/ISSUE-123/transitions, using an issue that is in the appropriate “open” state.
      • By mousing over the link for the transition you want and looking for the action parameter in the URL. The transition ID may vary between workflows (for example, a bug instead of a story), even if the status you’re changing to is the same.
  2. Refer to the Configure WVS instructions.
  3. Select the Enable Jira transitions setting.
  4. Select the Custom transitions option.
  5. Enter your transition IDs in the text field. If you insert multiple transition IDs (separated by , or ;), the issue is moved to each state, one after another, in the order you specify. If a transition fails, the sequence is aborted.

Disable comments on Jira issues

WVS can cross-link source commits or merge requests with Jira issues without adding a comment to the Jira issue:

  1. Refer to the Configure WVS instructions.
  2. Clear the Enable comments checkbox.