Search Syntax#
For most searches, one or two words are enough. With search expressions you can be more precise: search for an exact phrase, restrict the search to one attribute, or exclude words.
Note
This page explains how to write search expressions. To learn how the search menu below the search field works, including the recently accessed items and the filters, see Search.
You can use search expressions in the search field in the header and in the search tabs. They follow the same rules as the Allegra Query Language. This page summarizes what you need most often. For all details, see The Allegra Query Language (AQL).
How Words Are Matched#
Allegra is tolerant when it matches your words, so you do not need to type them exactly:
Upper and lower case do not matter.
A word of four or more characters also finds words that begin with it. For example,
planfinds “planning”.Longer words are also found if they contain a typing error. One wrong character is tolerated in words of six or more characters, two in words of twelve or more.
Numbers are always matched exactly.
If you enter several words, Allegra finds everything that contains at least one of them. Objects that contain all of the words rank higher.
Note
The system administrator can configure the search so that all words must be contained.
Search Expressions#
To find |
Enter |
Example |
|---|---|---|
An exact phrase |
Quotation marks |
|
All of the words |
|
|
At least one of the words |
|
|
Results without a word |
|
|
Words in one attribute only |
Attribute name and colon |
|
Any single character |
|
|
Any number of characters |
|
|
Similar words |
|
|
Words close to each other |
|
|
A range of values |
|
|
Note the following rules:
Write the operators
AND,ORandNOTin capital letters.Use brackets to group expressions, for example
(invoice OR receipt) AND 2026.If you mark a word with
*,~or quotation marks, it is searched exactly as you typed it, without the automatic tolerance.
Examples#
The following examples show typical searches. You can type them into the search field exactly as shown.
You want to find |
Enter |
What you get |
|---|---|---|
Everything about invoices |
|
Everything that contains “invoice”, and also “invoices” or “invoicing” |
Something you only remember the beginning of |
|
“migration”, “migrate”, “migrated” and so on |
An exact wording |
|
Only texts in which these two words follow each other |
Texts that contain two words |
|
Only results that contain both “login” and “password” |
Texts that contain one word or another |
|
Results that contain “invoice”, “receipt” or both |
A topic without the test items |
|
Results that contain “migration” but not “test” |
A word in the title only |
|
Items with “login” in the title. Matches in descriptions or comments are ignored. |
Bugs about a topic |
|
Items of the type “Bug” that contain “login” |
A name you are not sure how to spell |
|
“Meier”, but also “Meyer” and “Maier” |
A word in an attached file |
|
Items with an attachment that contains “contract” in its name or content |
Several conditions at once |
|
Items with “login” in the title that also contain “error” or “fails” |
An item whose number you know |
|
Exactly the item with the number 1234 |
Searching in an Attribute#
To restrict a word to one attribute, put the attribute name and a colon in front of it. You can use the name as it appears in your language. Upper and lower case do not matter. If the name contains a space, put it in quotation marks:
"Item type":Bug
The attribute name applies only to the word or phrase that directly
follows it. In Title:data migration only “data” is searched in the
title. Use Title:"data migration" or
Title:data AND Title:migration instead.
To search in the data linked to an item, use these names:
Name |
Searches in |
|---|---|
|
Names, descriptions and content of attachments |
|
Comments of links to other items |
|
Expenses booked on the item |
|
Descriptions of budgets and planned values |
|
Consulted and informed persons |
Finding an Item by Its Number#
If you know the number of an item, you can open it without searching for its text:
itemId:1234finds exactly the item with the number 1234. Enter nothing else in the search field. This number is the system-wide item number. You can search for it even if your system uses workspace-specific item numbers.If your system uses workspace-specific item numbers, enter the number with its prefix, for example
ABC-12.
A number without itemId: is searched in all attributes. It finds the
item with this number, but also items that contain the number in their
title or description.
If a Search Expression Is Not Accepted#
The search menu shows no results while an expression is incomplete, for example while a quotation mark is still open. The search tabs show a message instead:
Message |
What to do |
|---|---|
The search text cannot be read as a search expression. |
Check that every quotation mark and bracket is closed and that
|
The search text expands to too many terms. |
Use longer or more specific words, especially together with
|