/
linksHierarchyVersion

linksHierarchyVersion

linksHierarchyVersion

linksHierarchyVersion

It takes a project version id or name is as input, gets all the issues affecting or fixing the version, takes all the root issues, builds the hierarchy structure of linked issues, applies the filter parameters and collects all the different issues into a list.

#

Name

Type

Required

Values

Description

1

Version

String

Yes

 

A version name or ID

2

depth

Integer

No

Integer between 1 and 5

Limits the depth of the hierarchy structure. Default is 1.

3

Link direction

String

No

'Inward' or 'outward'

Excluded link direction

4

Link type

String

No

The link type name

List of the excluded link types separated by comma

5

Issue type

String

No

The issue type name

List of the excluded issue types separated by comma

6

Version name

String

No

The version name

The name of the versioned issues to exclude. It applies to the affects and fix version issue fields.

7

Resolved

String

No

Yes or No

Yes: include the resolved issues (default)
No: exclude the resolved issues

Examples

we take the following data as an example:

issues that have 'Version Beta 2'

links Hierarchy of PUB-2 (depth 2)

links Hierarchy of PUB-84 (depth 2)

#Example 1: 

Get the links hierarchy of level 2 for the version 'Version Beta 2'.

#Example 2: 

Get the links hierarchy of level 2 for the version 'Version Beta 2', excluding issues that have 'Version2'

 

 

  • PUB-71: filtered by having only 'Version2'. By filtering PUB-71, their descendants are not collected.

  • LH-5: not filtered by also having 'Version3'

 

 

 

 

 

 

#Example 3: 

Get the links hierarchy of level 2 for issues that don't have only 'Version Beta 2'

 

 

  • PUB-84: filtered by having only 'Version Beta 2'. By filtering PUB-84, their descendants are not collected.

  • PUB-2: not filtered by also having 'Version Beta 3'.

 

 

 

 

 

 

#Example 4: 

Get the links hierarchy of level 2 for the version 'Version Beta 2', excluding issues that have 'Version Beta 2' and 'Version Beta 3'

 

  • PUB-84: filtered because all its versions are in the excluded versions. By filtering PUB-84, their descendants are not collected.

  • PUB-2: filtered because all its versions are in the excluded versions. By filtering PUB-2, their descendants are not collected.

 

 

 

 

 

 

#Example 5: 

Get the links hierarchy of level 2 for the version 'Version Beta 2', excluding issues that have not version

 

 

  • PUB-8: filtered because it has no version.

  • PUB-85: filtered because it has no version.

  • PUB-1: filtered because it has no version. By filtering PUB-1, their descendants (LH-5 and PUB-3) are not collected, although LH-5 have versions.

 

 

 

 

 

 

Contact us in case of any questions support@marketplace.expert