Introduction

​

The plugin features a rich and defined set of JQL queries and properties. These can be used in the issue search filed, and in filters as well.

​

Note that the App is for Jira Cloud.

​

Installation

​

The installation is as usual. Go to apps, find the plugin, and use the install button to  get the app deployed on your host.

​

When installed, click Configure or Getting Started. This will take you to the main App page.

​​

Preparement

​

In the top of the main App page (you can always find a link the Apps section), you will see the main header. The app will need to prepare, by pre-computing stuff on all your issues. This is not the same as JIRA indexing. But it will take some time. Expect 6 minutes per 1000 issues. The speed is throttled to that speed, to avoid rate limiting. You can follow the progress in the header.

​

When done, it will say "App is READY".

​

Searching

​

As usual, use the issue search page to find issues. Now you use the JQL functions and properties the App supplies as well. See the reference here, and use examples to get going.

​

Reference

​

The documentation for functions and operators are now found here:

https://yplugins.atlassian.net/wiki/spaces/JL/overview

​

JQL Part 2

​​

The JQL Part 2 App extends with even more properties. Here are the list:

​​​

Issue links (properties)
 

1. jqllib_linksCount 

   • Description: find issues which has the count of issue links defined.

   • Example of JQL query: "jqllib_linksCount = 2". It returns issues which have 2 links to other issues defined.
      

2. ​jqllib_linksDistinctIssueCount

   • Description: find issues which has the count of issue links defined, but where the issues are distinct (meaning not counting different link types to same issue).​

   • Example: "jqllib_linksDistinctIssueCount = 2"
      

3. ​jqllib_linksOutwardDistinctIssueCount

   • Description: as above, but only issues linked outward, e.g. if issue SCRUM-150 blocks EPIC-100, then SCRUM-150 has a outward link to EPIC-100
      

4. jqllib_linksInwardDistinctIssueCount (as above, but for inward links)
    

5. jqllib_linksTo

   • Description: a list of issue keys that are linked to outward.​

   • Example: "jqllib_linksTo IN (EPIC-100)" will return SCRUM-150 in the above example (jqllib_linksDistinctIssueCount).
      

6. jqllib_linksFrom​ (as linksTo, but those issue keys that are linked inward)
    

7. jqllib_linksToProjects

   • Description: like linksTo, but gives unique set of project​ keys for the issues that are linked to outward.
      

8. jqllib_linksFromProject (like above, but for issues linked to inward​)
    

9. jqllib_linksType

   • Description: search an array of types of the links (inward and outward)​

   • Example: "jqllib_linksType = 'is blocked by'" returns issues which has a link that is defined by value "is blocked by" (other values could be 'blocks', 'clones', 'is cloned by' etc.. (list of valid values can be seen in the "create link" box on a Jira issue)

​​

​​​

Weblinks (properties)
 

1. jqllib_weblinkGlobalId

   • Description: Search web links which have a global ID defined (string value).

   • Example of JQL query: jqllib_weblinkGlobalId = "main".
      

2. jqllib_weblinkApplication

   • Description: Search web links which have a application of some string value.

   • Example of JQL query: jqllib_weblinkApplication = 'confluence'
      

3. jqllib_weblinkTitle​

   • Description: Search web links which have a title of some string value​

   • Example: jqllib_weblinkTitle = 'Security Section'
      

4. jqllib_weblinkUrl:​

   • Description: Search weblink of url (string value)​

   • Example: jqllib_weblinkUrl = 'https://security.intranet.corp'
      

5. jqllib_weblinkUrlParts:​

   • Description: Search parts of the weblink url​ of issues

   • Example JQL query: jqllib_weblinkUrlParts in ('security','protected'). Having an URL defined (as web link on issue) as http://security.intranet.corp will match.
      

6. jqllib_weblinkSummary

   • Description: Search summary of web link.​

   • Example: jqllib_weblinkSummary = 'Link to security'

​

​

​

​

​

​

​

​

​