Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Improved OR example.

...

Note: Terms found by the fuzzy search will automatically get a boost factor of 0.2

Anchor

Proximity searches

JIRA supports finding words are a within a specific distance away. To do a proximity search use the tilde, "~", symbol at the end of a Phrase. For example to search for a "atlassian" and "jira" within 10 words of each other in a document use the search:

Code Block
"atlassian jira"~10

...

Boosting a term: ^

JIRA provides the relevance level of matching documents based on the terms found. To boost a term use the caret, "^", symbol with a boost factor (a number) at the end of the term you are searching. The higher the boost factor, the more relevant the term will be.

...

By default, the boost factor is 1. Although, the boost factor must be positive, it can be less than 1 (i.e. .2).

anchor 

Boolean operators

Boolean operators allow terms to be combined through logic operators. JIRA supports AND, "+", OR, NOT and "-" as Boolean operators.

Info

Boolean operators must be ALL CAPS.

Anchor

OR

The OR operator is the default conjunction operator. This means that if there is no Boolean operator between two terms, the OR operator is used. The OR operator links two terms and finds a matching document if either of the terms exist in a document. This is equivalent to a union using sets. The symbol || can be used in place of the word OR.

To search for documents that contain either "atlassian jira" or just "jiraconfluence" use the query:

Code Block
"atlassian jira" || jiraconfluence

or

Code Block
"atlassian jira" OR jira

...

confluence

AND

The AND operator matches documents where both terms exist anywhere in the text of a single document. This is equivalent to an intersection using sets. The symbol && can be used in place of the word AND.

...

Code Block
"atlassian jira" AND "issue tracking"

...

Required term: +

The "+" or required operator requires that the term after the "+" symbol exist somewhere in a the field of a single document.

...

Code Block
+jira atlassian

...

NOT

The NOT operator excludes documents that contain the term after NOT. This is equivalent to a difference using sets. The symbol ! can be used in place of the word NOT.

...

Info

Usage of the NOT operator over multiple fields may return results that include the specified excluded term. This is due to the fact that the search query is executed over each field in turn and the result set for each field is combined to form the final result set. Hence, an issue that matches the search query based on one field, but fails based on another field, will be included in the search result set.

...

Excluded term: -

The "-" or prohibit operator excludes documents that contain the term after the "-" symbol.

...

Code Block
"atlassian jira" -japan

...

Grouping

JIRA supports using parentheses to group clauses to form sub queries. This can be very useful if you want to control the boolean logic for a query.

...