Advanced searching - Atlassian Documentation [PDF]

Sep 20, 2017 - The advanced search allows you to build structured queries using the Jira Query Language (JQL) to search

3 downloads 24 Views 45KB Size

Recommend Stories


PdF Online Searching
No matter how you feel: Get Up, Dress Up, Show Up, and Never Give Up! Anonymous

MuleSoft Documentation [PDF]
Mule supports SAP integration through our Anypoint Connector for SAP, which is an SAP-certified Java connector that leverages the SAP Java Connector ... Function , which is the container for parameters and/or tables for the SAP Function Module (BAPI)

Advanced PDF
Don't watch the clock, do what it does. Keep Going. Sam Levenson

Searching and Sorting Algorithms, Complexity Analysis Searching Algorithms Searching
Learn to light a candle in the darkest moments of someone’s life. Be the light that helps others see; i

Data Documentation | PDF, 3.18 MB
What we think, what we become. Buddha

JEDI Documentation Documentation
What you seek is seeking you. Rumi

Documentation Technique Documentation Technique
So many books, so little time. Frank Zappa

Technical Technical Documentation Documentation Documentation Introduction Introduction
When you talk, you are only repeating what you already know. But if you listen, you may learn something

bibliography - Philosophy Documentation Center [PDF]
Aug 18, 2008 - Bermùdez, José Luis, Anthony Marcel, and Naomi Eilan eds., The Body and the Self [BS]. Cambridge, MA: MIT ...... Naukkarinen, Ossi. Aesthetics of the Unavoidable: Aesthetic Variations in. Human Appearance [AU]. Saarijärvi: Gummerus

Searching Handout
If you want to go quickly, go alone. If you want to go far, go together. African proverb

Idea Transcript


Using the early preview of the new Jira experience? Read our new Jira experience guide to learn about it.

Advanced searching The advanced search allows you to build structured queries using the Jira Query Language (JQL) to search for issues. You can specify criteria that cannot be defined in the quick or basic searches (e.g. ORDER BY clause). If you don't have complex search criteria, you may want to use quick search instead. If you are not comfortable with the Jira Query Language (JQL), you may want to use basic search instead. JQL is not a database query language, even though it uses SQL-like syntax.

Advanced searching 1. Navigate to Issues (in header) > Search for issues. If there are existing search criteria, click the New filter button to reset the search criteria. If the basic search is shown instead of the advanced search, click Advanced (next to the

icon).

2. Enter your JQL query. As you type, Jira will offer a list of "auto-complete" suggestions based on the context of your query. Note, auto-complete suggestions only include the first 15 matches, displayed alphabetically, so you may need to enter more text if you can't find a match. 3. Press Enter or click

to run your query. Your search results will display in the issue navigator.

Understanding advanced searching Read the following topics to learn how to get the most out of advanced searching: Constructing JQL queries | Setting the precedence of operators | Restricted words and characters | Performing text searches

Constructing JQL queries A simple query in JQL (also known as a 'clause') consists of a field, followed by an operator, followed by one or more values or functions. For example: project = "TEST" This query will find all issues in the "TEST" project. It uses the "project" field, the EQUALS operator, and the value "TEST". A more complex query might look like this: project = "TEST" AND assignee = currentuser() This query will find all issues in the "TEST" project where the assignee is the currently logged in user. It uses the "project" field, the EQUALS operator, the value "TEST",the "AND" keyword and the "currentuser()" function. For more information on fields, operators, keywords and functions, see the Reference section below.

Setting the precedence of operators You can use parentheses in complex JQL statements to enforce the precedence of operators. For example, if you want to find all resolved issues in the 'SysAdmin' project, as well as all issues (any status, any project) currently assigned to the system administrator (bobsmith), you can use parentheses to enforce the precedence of the boolean operators in your query, i.e. (status=resolved AND project=SysAdmin) OR assignee=bobsmith Note that if you do not use parentheses, the statement will be evaluated left-to-right. You can also use parentheses to group clauses, so that you can apply the NOT operator to the group.

Restricted words and characters Reserved characters JQL has a list of reserved characters:

space (" ")

+

.

,

;

?

|

*

/

%

^

$

#

@

[

]

If you wish to use these characters in queries, you need to: surround them with quote-marks (you can use either single quote-marks (') or double quote-marks (")); and, if you are searching a text field and the character is on the list of reserved characters for text searches, precede them with two backslashes. For example: version = "[example]" Note that most special characters cannot be searched for in text fields using this method. For advanced text searches, see Search syntax for text fields. Reserved words JQL also has a list of reserved words. These words need to be surrounded by quote-marks (single or double) if you wish to use them in queries. Show me...

Performing text searches You can use text-searching features when performing searches on the following fields, using the CONTAINS operator: Summary, Description, Environment, Comments, custom fields that use the "Free Text Searcher" (i.e. custom fields of the following built-in custom field types: Free Text Field, Text Field, Read-only Text Field). For more information, see Search syntax for text fields.

Reference

Description

Reference

Fields

A field in JQL is a word that represents a Jira field (or a custom field that has already been defined in Jira).

Operators

An operator in JQL is one or more symbols or words that compare the value of a field on its left with one or more values (or functions) on its right, such that only true results are retrieved by the clause. Some operators may use the NOT keyword.

See the following pages: Advanced searching functions reference Advanced searching fields reference

A keyword in JQL is a word or phrase that does (or is) any of the following:

Advanced searching keywords reference

joins two or more clauses together to form a complex JQL query Keywords

Advanced searching operators reference

alters the logic of one or more clauses alters the logic of operators has an explicit definition in a JQL query



performs a specific function that alters the results of a JQL query. A function in JQL appears as a word followed by parentheses, which may contain one or more explicit values or Jira fields. Functions

A function performs a calculation on either specific Jira data or the function's content in parentheses, such that only true results are retrieved by the function, and then again by the clause in which the function is used.

Running a saved search Saved searches (also known as Saving your search as a filter) are shown in the left panel, when using advanced search. If the left panel is not showing, hover your mouse over the left side of the screen to display it. To run a filter, e.g. My Open Issues, simply click it. The JQL for the advanced search will be set, and the search results will be displayed.

Troubleshooting Why can't I switch between basic and advanced search? In general, a query created using basic search will be able to be translated to advanced search, and back again. However, a query created using advanced search may not be able to be translated to basic search, particularly if: the query contains an OR operator. Instead, you can use an IN operator and it will be translated. For example: project in (A, B) the query contains a NOT operator the query contains an EMPTY operator the query contains any of the comparison operators: !=, IS, IS NOT, >, >=,

Smile Life

When life gives you a hundred reasons to cry, show life that you have a thousand reasons to smile

Get in touch

© Copyright 2015 - 2024 PDFFOX.COM - All rights reserved.