Define the Jira issues to be displayed

Define the Jira issues to be displayed, using Jira query language (JQL). Don't worry, you don't need to be experienced with Jira query language in order to use this feature, though it might come in handy at one place or another.

Don't worry

JQL stands for JIRA Query Language. It is widely used across JIRA and allows users and admins to perform more advanced searches.

  1. If you have never used it before, go to your JIRA instance and into the global search. By pressing the Return key without typing in anything you will be forwarded to the page we need.
  2. Here you can configure the search query that you desire by activating the necessary checkboxes. As soon as you are satisfied, hit the "Advanced" tag to the right.

  3. The checkboxes and lists should disappear and instead of them there should be a JQL Query that you can copy, and paste wherever you need it.
  4. If you want to get back to your checkboxes hit the "Basic" button to the right.

For more information visit the Atlassian Documentation. It contains a much more detailed explanation on how JQL Queries work.

Step-by-Step Guide

By using the Jira query language (JQL) in TaskONE you can filter the shown issues that are relevant for you.

Step  ProcedureExampleDescription
1Go to a Confluence page that already has TaskONE for Confluence and click on the Edit button in the top right corner, or insert the macro to any page.

If you can not see it, you do likely not have the necessary permissions to edit the page displayed.

For more help please contact your local Confluence Administrator.

2Next click on the TaskONE macro and wait for a dialogue to appear and click the Edit button. 

3In there you have to scroll down to the very bottom to reach the Jira Query Language (JQL) box.

You need to link your Confluence instance with your Jira instance in order to use this feature.

If you find any trouble during this tutorial, ask your local Confluence Administrator if the applications are linked.

4Type your chosen JQL down.
The JQL should not contain an order like e.g. ORDER BY created DESC, otherwise TaskONE shows an error message.
5Press Preview to see the results of your JQL.

If you happen to see an error message that looks like this:

Verify that you have used correct JQL language.

Since not all JQL functions are supported, this may also cause this error to appear.

6Next hit the Save button and congratulations, you have successfully added Jira issues to your TaskONE list.