Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
titleAvailability
  • This routine is available starting with SIL Engine™ 2.5 for Jira 5.x.
  • This routine is available for Jira server and cloud deployment options.

Syntax

...

Table plus
applyColStyleToCelltrue
heading0
columnTypess,s,s,s
multiplefalse
columnAttributesstyle="background:#e5e7ea;font-weight:bold,,style="background:#e5e7ea;font-weight:bold,
enableSortingfalse

Syntax

linkedIssues(issueKey, [[linkTypeName], [direction]])

...

Package

Alias

getLinkedIssues (issueKey, [[linkTypeName], [direction]])

Pkg Usage

Description

Excerpt
hiddentrue
Returns an array with the Issue keys linked with the specified one.

Returns an array with the Issue keys linked with the specified one.
This routine searches for all the the linked issues  with with the one given as argument (parameter) and builds an array that contains them. The second parameter parameter [linkTypeName] is is optional and represents a searching filter that selects only those issues that have a certain relation (link type) with the argument issue.
The The Issue types  that that can be given as arguments are:

  1. Blocks
  2. Relates
  3. Clones Clones

...

Info

The [direction] parameter is available starting with version 2.5.8 of SIL Engine™.

...

Parameters

Table plus
applyColStyleToCelltrue
columnTypess,s,s,s
heading0
multiplefalse
enableSortingfalse

Parameter name

Type

Required

Description

issueKey

...

String

Yes

Specifies a string representing the key of the issue.

linkTypeName

...

String

No

Specifies the link type.

direction

number

No

-1, 0, 1 :Negative means inward links. Positive means outward links. Use zero to get both outward and inward links.

Return

...

an array of strings

...

Type

String[]

Example

A good way to understand the idea of this routine is by using an example, so:

Let's consider the following three issues: "TUT-1", "TUT-2" and "TUT-3".

The issue "TUT-1" has the following links:

  1. Is blocked by "TUT-3 LinkedIssue3"
  2. Relates to "TUT-2 LinkedIssue2"

Image Removed

...

Code Block

...

Code Block
return linkedIssues("TUT-1","Blocks");

...

For the above example you will get the same result by running the following code:

Code Block
return linkedIssues("TUT-1", "Blocks", -1);

 "is blocked by" represents the inward description for the "Blocks" link type.

But if we run the following code:

Code Block
return linkedIssues("TUT-1");

The result will be an array with two elements: "TUT-3|TUT-2", because both issues are linked with "TUT-1".

See also

Filter by label (Content by label)
showLabelsfalse
max25
showSpacefalse
cqllabel = "jira_linkslink_routine" and space = currentSpace ( )
labelsjiraarray_links_routineroutines