Info |
---|
|
- 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 |
---|
applyColStyleToCell | true |
---|
heading | 0 |
---|
columnTypes | s,s,s,s |
---|
multiple | false |
---|
columnAttributes | style="background:#e5e7ea;font-weight:bold,,style="background:#e5e7ea;font-weight:bold, |
---|
enableSorting | false |
---|
|
Syntax | linkedIssues(issueKey, [[linkTypeName], [direction]]) | |
...
| Package | | Alias | getLinkedIssues (issueKey, [[linkTypeName], [direction]]) | Pkg Usage | |
|
Description
Excerpt |
---|
|
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:
- Blocks
- Relates
- Clones Clones
...
Info |
---|
The [direction] parameter is available starting with version 2.5.8 of SIL Engine™. |
...
Parameters
Table plus |
---|
applyColStyleToCell | true |
---|
columnTypes | s,s,s,s |
---|
heading | 0 |
---|
multiple | false |
---|
enableSorting | false |
---|
|
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:
- Is blocked by "TUT-3 LinkedIssue3"
- Relates to "TUT-2 LinkedIssue2"
Image Removed
...
...
|
---|
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) |
---|
showLabels | false |
---|
max | 25 |
---|
showSpace | false |
---|
cql | label = "jira_linkslink_routine" and space = currentSpace ( ) |
---|
labels | jiraarray_links_routineroutines |
---|
|