Undocumented JQL Functions - IssueImplements, IssueBlocks etc....

wvacchiani

Hi,  

JQL seems to have some undocumented function which I would like to know how to use.  They appear in the JQL Filter builder (for want of the correct terminology) but aren't documented on the JQL filter pages I've refer to.

If anyone has used these and worked out they work, please pass it on.

They all refer to specific Linkage types so I am going to guess they all work the same.

The couple in particular I am looking at are:

IssueImplements

IssueBlocks

They look like specific link checks but they don't seem to operate that way.

For example:  I tried IssueImplements = Empty, expecting that to return issues where the Issue has no implements link and it didn't. I know I can check via the IssueLinkType function as well, that is what I am currently doing, but if IssueImplements provides further functionality, it would be good to know.

Thanks. 

Trudy P Claspill

Hello @wvacchiani 

Welcome to the Atlassian community.

Those correspond to Issue Link Types.

If you use

IssueBlocks = ABC-123

...you will get back the issues that are linked to ABC-123 such that they "block" ABC-123

If you use

issueIsBlockedBy = ABC-456

...you will get back the issues that are linked to ABC-456 such that they "is blocked by" ABC-456

If you have linked issues thus:

ABC-123 blocks ABC-456

...then

issueBlocks=ABC-456

...will return ABC-123. And

issueIsBlockedBy=ABC-123

...will return ABC-456

 

All link types come as a paired relationship:

blocks / is blocked by

clones / is cloned by

implements / is implemented by

The options you see in JQL will depend on the Link Types that have been defined for your Jira instance. Here are examples from mine:

 

The options will match to the Inward and Outward Descriptions of your link types.