Tutorials for Advanced Search in Jira

Tutorials for Advanced Search in Jira

That is, it is used to search for issues where the specified field has a value. That is, it is used to search for issues where the specified field has no value. The Jira Query Language, or JQL, is a convenient way to access Jira issues and find the information that you need. Keywords connect different and/or multiple parts of a query.

jira query language cheat sheet

Search for issues that were updated by a specific user, optionally within the specified time range. An update, in this case, includes creating an issue, updating what are JQL queries and how to use them any of the issue’s fields, creating or deleting a comment, or editing a comment (only the last edit). Where inc is an optional increment of (+/-)nn(y|M|w|d|h|m).

Building JQL Queries

When you have hundreds of columns and tens of thousands of rows, it’s much easier to use a database to store information and use Structured Query Language (SQL) to access the data. You can even create custom software that runs SQL queries to retrieve data and presents it in intuitive ways. Note that this function can only be used by logged-in users. Perform searches based on issues for which you have voted. Note, this function can only be used by logged-in users.

If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. endOfMonth(“+1”) is the same as endOfMonth(“+1M”). If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. endOfDay(“+1”) is the same as endOfDay(“+1d”). Jira basic search is very simple, it have user interface where you can simply select the values and it will show you the results.

Additional Help

The Full-Text Search Attachments for Jira Plugin, for example, enables JQL statements to search attachments for the name, type, and content. You can even build your own plugins with Java, JavaScript, CSS, and HTML skills. I think I need to provide every new project admin the graphic you’ve included in your comment  These concerts are often difficult for new users to grasp. This suggests that Tasks are located on a lower hierarchy level than Stories and can be children of Stories, when the truth is that they are both on the same level.

jira query language cheat sheet

Both Stories and Tasks are of type Standard Issue as opposed to Subtasks which are of type Sub-Task Issue. Workflow – Workflow is the logic that drives movement of a stories / sub-task along their development journey on a scrum or kanban board. Story – A story or user story is a software system requirement that is expressed in a few short sentences, ideally using non-technical language. Scrum of Scrums – Scrum of Scrums is a means of scaling Scrum to large, multi-team projects.

Constr­ucting JQL Queries

You can add as many as filters and your results will be displayed as per filters. Be aware that this can sometimes lead to unexpected results. For example, suppose one issue contains the text phrase “VSX will crash” and another issue contains the phrase “VSX will not crash”.

jira query language cheat sheet

For instance, one of the popular plugins that we developed – Automated Release Notes for Jira pulls relevant Jira issues based on JQL to compile release notes automatically. Even the Roadmap Portal for Jira Service Desk add-on is based on JQL which helps gather feedback and votes from your Jira service desk customers. These tools help in automating important but routine aspects of the software development life cycle, freeing up valuable time for managers and developers. Before building a query, understanding a few of its different components is essential. Knowing what fields, Values, operators, and keywords denote will result in an efficient query. Epics can be parent of any other standard issue type (story, task, bug, test or anything else you want at that level).

jira query language cheat sheet

Search for issues that are assigned to a sprint that was started, but has not yet been completed. Perform searches based on the latest released version (i.e. the most recent version that has been released) of a specified project. Search for issues that are due by the end of the last day of the current week. By default, this function considers Saturday to be the last day of the week. You can use a different day (for example, Sunday) as the end of the week. Perform searches based on the earliest unreleased version in a project.

  • These queries are similar in nature, even though they operate on different platforms.
  • If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. endOfWeek(“+1”) is the same as endOfWeek(“+1w”).
  • Perform searches based on the start of the current month.
  • Even the Roadmap Portal for Jira Service Desk add-on is based on JQL which helps gather feedback and votes from your Jira service desk customers.
  • Sprint planning – A team planning meeting that determines what to complete in the coming sprint.
  • The “+” or required operator requires that the term after the “+” symbol exists somewhere in a the field of a single document.

Leave a Reply

Your email address will not be published. Required fields are marked *

No Comments