You are browsing the documentation for iTop 2.2 which is not the current version.

Consider browsing to iTop 3.2 documentation


A search tab (Search tab) is present in many places in iTop. Clicking on this tab toggles the display of a multi-criteria search form. Inside the form, the search button (Search button) is used to launch the search once the criteria have been filled.

A search form

All the criterias of the search form are combined together using a AND operator. This means that when searching for Tickets, if you specify “Demo” as the Organization and “High” as the severity, the search results will list all the Tickets of the Organization “Demo” which have a “High” priority (Organization = Demo and Priority = High).

Date Fields

The format for dates used by iTop is always the same: it is the year on 4 digits, followed by a dash, followed by the month expressed on 2 digits, followed by a dash and finally the day on 2 digits. (In short: YYYY-MM-DD)

For the fields holding a date and a time, the format is the same but the date is followed by a space then the hours on 2 digits (24 hours format) followed by a colon (:) followed by the minutes on two digits followed by a colon (:) and the seconds on two digits. (In short: YYYY-MM-DD hh:mm:ss).

Shortened dates and times:

The “time” part, but also the day or even the month information can be omitted for the date expression, in which case the resulting date will be equivalent to the beginning of the period. For example searching for >2012-12 is equivalent to searching for >2012-12-01 00:00:00. Searching [2011,2013] will match all dates in 2011 and 2012, since it will search for [2011-01-01 00:00:00,2013-01-01 00:00:00]

When a field contains a date, some special operators are allowed. Such operators are specified by typing them directly in the search field:

Operator Meaning Example
< Strictly less than Type <2012-01-01 to search for any date before the first day of 2012
> Strictly greater than Type >2011-12-31 to search for any date after the last day of 2011
[date1,date2] In the range [2012-01-01,2012-01-31] To search for any date in January 2012 (including the first and last day of the month)

When placing the pointer of the mouse over a date field, a tooltip with some explanations appears:

Operators on date fields

When a search field is a date and time field, remember to use the operators to specifiy your search. In fact searching for tickets which “Close date” is “2012-11-01” will probably not return any match, since it is quite unlikely to find many tickets which were closed exactly on 2012-11-01 at 00:00:00. So, to find all tickets closed on the first of November use the syntax: [2012-11-01,2012-11-02]

The “Global search” feature is located at the top right of all iTop pages.

Global search

The global search searches for the given string of text inside all the objects in iTop. To launch the search enter the text to search and click on the magnifier icon or press the ENTER key of your keyboard.

The search results are displayed by groups: all the matching objects of the same class are grouped together in one table.

Since the global search searches in all the objects of the iTop database it can become quite slow when the number of object increases, however you can speed-up the search by limiting its scope to a given class of objects. The syntax to specify the scope of the global search is the following: class_name: text_to_search.

Global search scope: Server

Searching for Server:webserv will search for all server objects containing the text “webserv” in any of their fields.

You can also specify as a scope a class that has subclasses. For example:

Global search scope: Contact

Searching for Contact:dali will search for all Teams and Persons containing dali in any of their fields.

The global search is not case sensitive. Searching for Dali, dali or DALI will give identical results.
2_2_0/user/search.txt · Last modified: 2018/12/19 11:40 (external edit)
Back to top

Table of Contents

Contact us