Finding Tasks:
←Older revision
Revision as of 21:37, 18 June 2013
(2 intermediate revisions not shown.)
Line 17:
Line 17:
== Finding Tasks ==
== Finding Tasks ==
-
The task list can be filtered by providing a phrase to match against the task summary. The phrase must appear in the summary of a task for the task to be visible when a filter is applied.
+
The task list can be filtered by providing a phrase to match against the task summary. The phrase must appear in the summary of a task for the task to be visible when a filter is applied.
The
task
list
filter
operates by searching on a locally-maintained index
of the
tasks in your task list
.
(In rare cases
,
it may be necessary
to
manually refresh the
search
index by selecting
"
Refresh Search Index
"
from
the task list
menu
.
)
-
+
-
To match against common
task
fields other than the summary, such as description or assignee, prefix
filter
terms with the name
of the
field
.
For example
, to search
for
"
NullPointerException
"
in
the task
description, specify description:NullPointerException. Content assist can be used to provide a
list
of common field names, and will provide a list of known user names when searching on user fields
.
+
+
*Search for task summary or task id by entering the value. For example, NullPointerException or 12345.
+
*Search for other task fields such as description or assignee by prefixing them with the field name. For example description:NullPointerException will search in the task description rather than the summary. Content assist can be used to provide a list of common field names, and will provide a list of known user names when searching on user fields.
[[Image:Task-list-index-reporter.png]]
[[Image:Task-list-index-reporter.png]]
+
*Search for date ranges by qualifying the range. For example, show tasks that were created in the (past week).
+
[[Image:Task-list-index-content-assist.png]]
+
*Search for an exact phrase by enclosing it in double-quotes. For example, description:"user experience".
+
*Search for partial words by using the "*" wildcard. For example, exc*tion matches both "exclamation" and "exception".
-
Fields
that specify dates can be filtered by specifying date ranges, e.g. show tasks that were created in the past 7 days only.
+
=== Available
Fields
===
-
+
-
[[Image:Task-list-index-content-assist.png]]
+
Available fields can be found by using content assist in the search field. The following fields are available for search with most repositories:
Available fields can be found by using content assist in the search field. The following fields are available for search with most repositories:
Line 65:
Line 67:
Some fields listed above may not be available depending on the repository and connector.
Some fields listed above may not be available depending on the repository and connector.
-
To search for a phrase, enclose the phrase with double-quotes, for example: description:"user experience"
+
=== Search Operators ===
-
The special character "*" can be used to match any string, allowing for matches against similar words. For example, "exc*tion" matches both "exclamation" and "exception".
+
-
The
keywords "AND" and "OR" can be used as
logical operators
to combine words in a query
.
"
AND
" requires
that
combined words all exist
,
whereas "OR" matches against tasks where at least one of the words is present. Logical
operators are case-sensitive
. If multiple
words are
provided and no logical operators, field names or wildcards are specified, a
phrase
match is performed instead
.
+
The
Task List provides
logical operators.
For example, NPE
AND
Display. Note
that
unlike other search phrases
,
'''search
operators are case-sensitive
'''; otherwise, the
words are
treated as part of the search
phrase.
-
The task list filter operates by searching on a locally-maintained index of the
tasks
in your task list
.
In rare cases, it may be necessary to manually refresh the search index by selecting "Refresh Search Index" from the task list menu
.
+
;AND
+
:Searches for
tasks
that contain both words
.
+
;OR
+
:Searches for tasks that contain at least one word
.
== Task List Presentation ==
== Task List Presentation ==