Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
The add-on provides Herzum Quick Linker provides a set of useful JQL functions to filter on the tickets linked viavia Herzum Quick Links:
Table of Contents
maxLevel2
1

From the

JIRA header

Jira menu, click Issues -> Search for Issues

Image Modified

Search for Issues tab

2

Click Advanced to switch the form to advance search mode using JQL.

Image Modified

Search screen

3

Enter the JQL function

Search screen

4

and Click the search icon to run the search.

The list of issues appears.JIRA search screen list view


Image Added

Search screen

hqlLinkedIssues

The hqlLinkedIssues(issueLinkTypeThe 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 or blocked by issues on any remote Jira instance.

issue in hqlLinkedIssues("Blocks", "", "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 admissible expected parameters in input are:

  • subquery ( Mandatory), it can be have any valid JQL clause.
  • link type (Optional), 
  • link versus (Optional), it can assumes have O (outward link type) and I (inward link type).

Examples

...

Assuming you have the following Issue Linking settings

Image Added

and the following Mapping

Image Added

Searching issues blocked by linked issues in a state not equal to Done

...

The JQL function  issue in hqlLinkedIssuesOf("status!=done", "Blocks", "O") will research all issues blocked by one/more issue/s not having status equal to done.

Image Added

Searching issues in a state not equal to Done, blocking linked issues having priority High

The JQL function issue in hqlLinkedIssuesOf("priority= High", "Blocks", "I") and status != Done will research all issues not having status equal to Done, blocking issues having priority equal to High.

Image Added