Difference between revisions of "ManualSearchTickets"

From Request Tracker Wiki
Jump to navigation Jump to search
m
m
(10 intermediate revisions by the same user not shown)
Line 9: Line 9:
Searches can be saved, shared between groups, placed on the home page, bookmarked in the browser, used in charts or even emailed within [[ManualDashboards|Dashboards]].
Searches can be saved, shared between groups, placed on the home page, bookmarked in the browser, used in charts or even emailed within [[ManualDashboards|Dashboards]].


= Quick search =
= Queue List =


Quick search is a box that you can see on the home page, by default. This is a table where rows are queues you can see and columns are active statuses, each cell of the table shows number of tickets.
[[File:Queue-List.png|Queue List portlet|thumb|500px]]
 
The Queue List is a portlet that you can see on the home page, by default. This is a table where rows are queues you can see and columns are active statuses, each cell of the table shows number of tickets.


Queue name and each number in this table is clickable, so you can jump to a page with search results.
Queue name and each number in this table is clickable, so you can jump to a page with search results.
Line 17: Line 19:
= Simple search =
= Simple search =


Simple search is an input box in the upper right of all pages, there is "Search" button next to the box. There is "Simple Search" button in the menu, as well, that leads to the simple search page with some hints.
Simple search is an input box in the upper right corner of all pages. You can also run a "Simple Search" by clicking on Search -> Tickets -> Simple Search from the top navigation bar, that leads to the simple search page with some hints.


This search allows you to use some magic, for example you can type in a ticket number, and jump directly to that ticket. Check out [[ManualSimpleSearch]].
This search allows you to use some magic, for example you can type in a ticket id, and jump directly to that ticket. Check out [[ManualSimpleSearch]].


= Advanced search =
= Advanced search =


'''NOTE''' This information is heavily based on RT 3.0 where query builder was different than in newer versions.
[[File:Query-Builder.png|Search Tickets with the Query Builder|thumb|500px]]


More advanced ticket search is available by clicking Tickets in the menu. This is a query builder with many fields listed for you to build your searches.
More advanced ticket search is available by clicking Search -> Tickets -> New Search in the menu. This is a query builder with many fields listed for you to build your searches.


It is fairly intuitive, but there are some features worth noting:
It is fairly intuitive, but there are some features worth noting:


* Searches, by default, are sticky. That is, if you return to the Search page during a session, it will display the most recent search (unless you click on the "new query" link).
* Searches, by default, are sticky. That is, if you return to the Search page during a session, it will display the most recent search (unless you click on the "New Search" link again in the main menu).
* Searches are, by default, limited. You can walk by pages or unlimit them.
* Searches are, by default, limited. You can walk by pages or unlimit them.
* Searches are iterative - you build them up. If you search for tickets owned by Jane, then search for open tickets, you'll get open tickets owned by Jane.
* Searches are iterative - you build them up. If you search for tickets owned by Jane, then search for open tickets, you'll get open tickets owned by Jane.
Line 36: Line 38:
If you get too many results, you can still pinpoint what you need by searching again to narrow the results down.
If you get too many results, you can still pinpoint what you need by searching again to narrow the results down.


You can search by owner, requestor email address, ticket subject, queue, priority, attachment, and/or status. For instance, you could search for tickets you own by selecting your own name from the Owner drop-down menu, or search for only high priority tickets.
You can search by id, ticket subject, queue, status, SLA, owner, requestor, group, time fields, date fields, priority, and/or links. For instance, you could search for tickets you own by selecting your own name from the Owner drop-down menu, or search for only high priority tickets.


== Relative Date Searching ==
== Relative Date Searching ==


Consider needing a bookmarkable search which lists what you've resolved in the last month or what is due in the next week. Manually entered dates make the search outdated soon after creation. The perl module that RT uses allows for some relative date/time phrases.
[[File:Relative-Date-Search.png|Example of using relative dates for searching|thumb|500px]]
 
Consider needing a bookmarkable search which lists what you've resolved in the last month or what is due in the next week. Manually entered dates make the search outdated soon after creation. The perl module that RT uses allows for some relative date/time phrases. Using the query builder, you can run these searches.


NOTE: See the [http://search.cpan.org/author/MUIR/Time-modules-2003.0211/lib/Time/ParseDate.pm Time::ParseDate man page] for more options
NOTE: See the [http://search.cpan.org/author/MUIR/Time-modules-2003.0211/lib/Time/ParseDate.pm Time::ParseDate man page] for more options
Line 48: Line 52:
Tickets resolved in the last month
Tickets resolved in the last month


  Resolved -> After -> -1 month
  Resolved -> After -> -1 month
   
   


Tickets created in the last week
Tickets created in the last week


  Created -> After -> -1 week
  Created -> After -> -1 week
   
   


Tickets due in the next week
Tickets due in the next week


  Due -> After -> Today AND Due -> Before -> +1 week
  Due -> After -> Today AND Due -> Before -> +1 week
   
   


Tickets created between an hour and three hours ago
Tickets created between an hour and three hours ago


  Created -> After -> -1 hour AND Created -> After -> -3 hour
  Created -> After -> -1 hour AND Created -> After -> -3 hour


== Advanced Search vs. other searches ==
== Advanced Search vs. other searches ==
Most interfaces that simplify search, like queue list and simple searches, at the end generate a query using special syntax and redirect you to results page that is part of advanced search. So you can click 'Edit Search' from the top submenu and refine it with more conditions or "Advanced" to write out the search query explicitly.


Most interfaces that simplify search, like quick and simple searches, at the end generate a query using special syntax and redirect you to results page that is part of advanced search. So you can click 'Edit Search' in the UI and refine it with more conditions.
= Search results =


= Search results =
Search results look like the following:


Search results looks like on the following [http://es.geocities.com/gpizarro1977/rtwiki/search.gif screenshot]. It's screenshot from old version.
[[File:Search-Results.png|Search Results|thumb|500px]]


== Changing display format ==
== Changing display format ==


You may also alter the number of search results returned per page, how the results are sorted, and how often the page is refreshed. Click the Search button when you're done.
At the bottom of the query builder page, you can also alter the number of search results returned per page, how the results are sorted, and which columns are displayed. From the search results page, you can select how often the page is refreshed. Click the Change button when you're done.


To bookmark a search so you can return to the results later:
To clear previous search results and start a new search:
* click Search -> Tickets -> New Search


* click Bookmarkable URL for this search
= Saving Searches =
* add the page to your Bookmarks, Favorites, or whatever applies for your browser


To clear previous search results and start a new search:
After you've added all of the criteria you want for a query, you can save your search.


* click New Search in the left side navigation bar
To save a search so you can return to the results later:
 
:# under Saved Searches on the query builder page, select a privacy (you can only save for yourself "My Saved Searches", or for a group you are a member of) and add a description
= Saving Searches =
:# click the Save button
'''NOTE''' You must have the correct permissions to show saved searches and to edit them.


After you've added all of the criteria you want for a query, before clicking search, first select where you'd like to save this search (the "Privacy" pulldown). You can save for only yourself "My Saved Searches", or for a group you are a member of "Group A's saved searches". Type in the description, then click save. Later, you can load the query from the "Load saved search" pulldown. You must have the correct permissions to show saved searches and to edit them.
To retrieve a saved search
:# under Saved Searches on the query builder page, select from the "Load saved search" dropdown
:# click the Load button


----
----
Line 95: Line 102:
Up: [[ManualUsingWebInterface]]
Up: [[ManualUsingWebInterface]]
[[Category:RT User Manual]]
[[Category:RT User Manual]]
[[Category:RT44]]

Revision as of 16:51, 28 March 2019

Up: ManualUsingWebInterface


Introduction

RT comes with several interfaces to search for tickets: queue list, simple search, and the query builder search.

Searches can be saved, shared between groups, placed on the home page, bookmarked in the browser, used in charts or even emailed within Dashboards.

Queue List

Queue List portlet

The Queue List is a portlet that you can see on the home page, by default. This is a table where rows are queues you can see and columns are active statuses, each cell of the table shows number of tickets.

Queue name and each number in this table is clickable, so you can jump to a page with search results.

Simple search

Simple search is an input box in the upper right corner of all pages. You can also run a "Simple Search" by clicking on Search -> Tickets -> Simple Search from the top navigation bar, that leads to the simple search page with some hints.

This search allows you to use some magic, for example you can type in a ticket id, and jump directly to that ticket. Check out ManualSimpleSearch.

Advanced search

Search Tickets with the Query Builder

More advanced ticket search is available by clicking Search -> Tickets -> New Search in the menu. This is a query builder with many fields listed for you to build your searches.

It is fairly intuitive, but there are some features worth noting:

  • Searches, by default, are sticky. That is, if you return to the Search page during a session, it will display the most recent search (unless you click on the "New Search" link again in the main menu).
  • Searches are, by default, limited. You can walk by pages or unlimit them.
  • Searches are iterative - you build them up. If you search for tickets owned by Jane, then search for open tickets, you'll get open tickets owned by Jane.
  • When RT displays a ticket that is part of the current search, it will also display Previous, Next, First, and Last links for navigating through the matching tickets.

If you get too many results, you can still pinpoint what you need by searching again to narrow the results down.

You can search by id, ticket subject, queue, status, SLA, owner, requestor, group, time fields, date fields, priority, and/or links. For instance, you could search for tickets you own by selecting your own name from the Owner drop-down menu, or search for only high priority tickets.

Relative Date Searching

Example of using relative dates for searching

Consider needing a bookmarkable search which lists what you've resolved in the last month or what is due in the next week. Manually entered dates make the search outdated soon after creation. The perl module that RT uses allows for some relative date/time phrases. Using the query builder, you can run these searches.

NOTE: See the Time::ParseDate man page for more options

Examples:

Tickets resolved in the last month

Resolved -> After -> -1 month

Tickets created in the last week

Created -> After -> -1 week

Tickets due in the next week

Due -> After -> Today AND Due -> Before -> +1 week

Tickets created between an hour and three hours ago

Created -> After -> -1 hour AND Created -> After -> -3 hour

Advanced Search vs. other searches

Most interfaces that simplify search, like queue list and simple searches, at the end generate a query using special syntax and redirect you to results page that is part of advanced search. So you can click 'Edit Search' from the top submenu and refine it with more conditions or "Advanced" to write out the search query explicitly.

Search results

Search results look like the following:

Search Results

Changing display format

At the bottom of the query builder page, you can also alter the number of search results returned per page, how the results are sorted, and which columns are displayed. From the search results page, you can select how often the page is refreshed. Click the Change button when you're done.

To clear previous search results and start a new search:

  • click Search -> Tickets -> New Search

Saving Searches

After you've added all of the criteria you want for a query, you can save your search.

To save a search so you can return to the results later:

  1. under Saved Searches on the query builder page, select a privacy (you can only save for yourself "My Saved Searches", or for a group you are a member of) and add a description
  2. click the Save button

NOTE You must have the correct permissions to show saved searches and to edit them.

To retrieve a saved search

  1. under Saved Searches on the query builder page, select from the "Load saved search" dropdown
  2. click the Load button

Up: ManualUsingWebInterface