Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • add new or existing versions to the hierarchy

  • manage all version details without switching to Releases project tabs

  • view all version details in the hierarchy tree grid

  • add the same version to multiple places in the hierarchy

  • group versions using folders

  • search versions in the hierarchy

  • find issues for any part of a project represented by versions hierarchy

  • select versions from hierarchy when editing issues

  • perform all operations with versions hierarchy using REST API

  • use custom JQL functions to search issues

Glossary

Throughout the documentation, we use some terms which we'd like to briefly explain before you continue.

...

  1. using hierarchy item View issues context actionvia JQL search with the help of custom JQL functions: subversions() and vrSubfolder()

View issues

Click on “View issues” action in the item context menu to open the View issues dialog with the list of issues.

...

In the background View issues screen utilizes JQL search capabilities to find the required issues and you can switch to Jira Issue Navigator to get more details about the issues.

JQL search

Versions hierarchy app adds two custom JQL functions to search issues in versions hierarchy: subversions and vrSubfolder.

The result of both functions is a list of versions, that's why you should use them in a combination with version field, e.g. "fixVersion in subversions(…)".

...

Function

...

Parameters

...

Examples

...

subversions()

...

  1. project key - key of the project to search in

  2. version name - find issues for this version and all its nested versions

You can optionally provide the third parameter as "false" to exclude issues of current version from the result

...

  • fixVersion in subversions("DEMO", "Version 1.0")

  • affectVersion in subversions("DEMO", "Version 1.1", "false")

...

vrSubfolder()

...

  1. project key - key of the project to search in

  2. folder name - find issues for all hierarchy items under this folder

...

  • fixVersion in vrSubfolder("DEMO", "folder 1")

Select versions in issue

Now let's explore how users can select versions from the hierarchy using Version hierarchy picker to add versions to issue.

...

Users can select versions from the hierarchy and add them to issue in addition to selecting from the plain list.

...

Versions hierarchy and Issue picker are fully supported in Jira Service Management projects.

...

.

Versions hierarchy picker settings

...