1 | From the JIRA header, click Issues -> Search for Issues | Search for Issues tab |
2 | Click Advanced to switch the form to advance search mode using JQL. | Search screen |
3 | Enter the JQL function and Click the search icon to run the search.
| Search screen |
hqlLinkedIssues
The hqlLinkedIssues([issueLinkType], [linkVersus], [partnershipType],[issueHierarchy]) JQL function searches for all issues linking to onother issue via the specified Link Type and,when specified, by having the specified link versus. Additional, it is possible to filter issues linking issues on any remote instance and further specialize the search for source/target issues.
The expected parameters in input are:
- LinkType (Optional),
- linkVersus (Optional), it can have O (outward link type) and I (inward link type)
- partnershipType (Optional), it can have local (local partnership) and remote ( partnership between two different JIRA instances)
- issueHierarchy (Optional), source (returns only the issue from whom the link has been created), target.
Examples
To find all the issues on the current JIRA instance blocking issues on any remote JIRA instance.
issue in hqlLinkedIssues("Blocks", "O", "remote", "")
hqlLinkedIssuesOf
The hqlLinkedIssuesOf(subquery, [link type], [link versus]) JQL function searches for all issues linked at least to one issue satisfying the filter and, when specified, having the specific link type and link direction.
The search is performed on issues linked via a local partnership only.
The expected parameters in input are:
- subquery ( Mandatory), it can have any valid JQL clause.
- link type (Optional),
- link versus (Optional), it can have O (outward link type) and I (inward link type).
Examples
Searching issues blocked by linked issues in a state not equal to Done
Assuming you have the following Issue Linking settings
and the following Mapping
The issues that are blocked by issues in a state not equal to Done, can be searched by running the following search:
issue in hqlLinkedIssuesOf("status!=done", "Blocks", "O")
The JQL function will research all issues linking to any issue not having status equal to done and having link equal to blocks.
Examples
Searching issues in a state not equal to Done, blocking linked issues having priority High
issue in hqlLinkedIssuesOf("priority= High", "Blocks", "I") and status != Done