Availability
This routine is available starting with katl-commons 1.1.2.
Syntax
linkIssue(issueKey1, issueKey2_or_url, issueLinkTypeName_or_linkText)
Description
Links two issues by a specified link type name. First issue will have the outward description of the link type, the second issue will have the inward description of the link type.Starting with katl-commons 4.0.14 you can also link the issue to a web link.
Parameters
Parameter name | Type | Required | Description |
|---|---|---|---|
issueKey1 | string | Yes | Key of the first issue to be linked. |
issueKey2_or_url | string | Yes | Key of the second issue to be linked or the URL. |
issueLinkTypeName_or_linkText | string | Yes | Issue link type name or the link text. |
Return type
None. The returned value has no meaning.
Examples
Example 1
linkIssue(key, "TST-123", "Relates"); //key represents the key of current issue, "TST-123" the key of the issue it will be linked to.
Result: current issue is linked to issue "TST-123" by Relates link type, such that "TST-123" relates to current issue and vice versa.
Example 2
linkIssue("TST-123", "TST-234", "Blocks");
Result: "TST-123" issue is linked to issue "TST-234" by Blocks link type, such that "TST-123" blocks "TST-234" and "TST-234" is blocked by "TST-123".
Example 3
linkIssue("TST-123", "https://confluence.example.com", "Confluence Documentation");
As a result, the TST-123 issue will be linked to https://confluence.example.com with the "Confluence Documentation" link text.
See also