Find Records
On this page
The Web App gives you two ways to find a record, and the header has a button for each:
- Search finds records by the text in their fields. A search runs over one class of record, over All Tickets or All CIs, or over Everywhere, a fixed set of classes searched together.
- Go To opens a record by its object ID.
Find records in the Web App
Search by text
- In the header, click Search. The Advanced Search panel slides down over the page with the cursor in its search box. Esc or a click outside the panel closes it.
- Type the words you are looking for. The box takes up to 250 characters.
- Click the class button next to the search box. It shows what the search runs over. Choose Everywhere, All Tickets, All CIs, or a class from the list below them. All Tickets is not offered under an ITAM-only license, and All CIs is not offered under an ITSM-only license. Choosing a class does not run the search.
- To set more options, click the arrow icon at the right end of the panel. The part with Search In and the additional filters opens.
- Under Search In, choose the fields to search:
- Frequently-used text fields, the default, searches a fixed set of fields for each class (see What is searched).
- A field of the class searches that field alone. For a person, E-mail and Login search the person's e-mail addresses and logins.
- Optionally, use the two field rows to narrow the results by the value of a field (see Narrow the results by a field).
- Optionally, set Created to limit the results to records created in a period. The button reads Created: Anytime until you choose one.
- Optionally, turn on Closed to include records that are in the class's inactive status, such as closed tickets and retired configuration items. Closed is off when Advanced Search opens, so those records stay out of the results until you turn it on. When you come back to an earlier search, the switch is kept as it was.
- Press Enter, or click Search.
The last entry of the class list opens your settings page, where you choose where your searches start (see Personal Settings).
Created, the field rows, and the activity log and history switches count only while the part with the additional filters is open. Closed counts either way. Closing that part, or clicking Clear All in it, sets Search In back to Frequently-used text fields, turns Closed and the activity log and history switches off, clears the field rows, and sets Created back to Anytime. The search text and the class stay as they are.
After the first search, the results appear as a list titled Search. On the results page, the search form is part of the page instead of a panel that slides down. Like any other list, the results can be sorted and have a context menu for their rows. Double-click a row to open the record. You can also open a record in a new tab, show the preview, and use Actions. You cannot create a record or run a batch update from the results, and Customize View for the results has no Filter tab. To refine the results, change the criteria and search again. When the server answers a search with a message instead of results, the page shows that message and no list.
The results page's URL preserves the search. Opening it again restores the criteria and whether the additional filters are expanded, then runs the search automatically. Back returns to the page you searched from.
When the search runs over Everywhere, the Search In list is hidden, and each class is searched in its own short list of fields (see What is searched). The part with the additional filters is titled Date Range and has no history switch and no field rows.
The Search button needs text in the search box. If you press Enter with the box empty, the search still runs with no words to match and lists the records of the class. Closed and the field rows still apply, and an Everywhere search is still narrowed by the Created period.
With Closed off, a search leaves out only records in the inactive status. A record that has no status is still found.
The panel also has switches that add the activity log and the history to the search. With the activity log switch on, the search also matches the details of the record's activity log entries. With the history switch on, it also matches the old values recorded in the record's history. An Everywhere search adds the activity log only, never the history. Like Closed, the activity log switch is off when Advanced Search opens and is kept as it was when you come back to an earlier search.
Narrow the results by a field
The additional filters hold two field rows. Each row has a field, an operator, and a value. There are always two rows; you cannot add another.
The operators depend on the type of the field:
- A yes/no field: Is true and Is false.
- A field that refers to another record or takes its value from a list: Equals, Does not equal, Is blank, and Is not blank.
- A date field: 1 Week, 1 Month, 6 Months, and Between.
- Any other field: Equals, Does not equal, Is blank, Is not blank, Contains, and Does not Contain.
Depending on the field, you pick the value from a list or type it. Between takes two dates. Is blank, Is not blank, Is true, Is false, 1 Week, 1 Month, and 6 Months take no value.
Choosing a field clears the row's operator and value, and choosing an operator clears the value. None in the field list clears the row, and None in the operator list clears the operator. Choosing another class clears both rows.
Choose a period for Created
Created offers Anytime, which sets no limit, and these periods:
- Today, Yesterday, Tomorrow, In the future, and In the past.
- For week, month, quarter, and year: This period, This period so far, Last period, and Next period (for example, This week, This month so far, Last quarter, Next year).
- Last 7 days, Last 14 days, Last 30 days, Last 60 days, Last 90 days, Last 180 days, and Last 365 days.
Once you choose a period, the button shows Created: followed by the period's English name, even when the Web App shows another language.
The period is worked out at the moment the search is sent, by the web server's clock. A day runs from midnight to midnight, a week starts on Sunday, and quarters start in January, April, July, and October. A so far period ends now, and In the future starts now. A Last N days period runs from midnight N days ago to the coming midnight, so it includes today. In the past does not narrow the results: it returns the same records as Anytime. For a class whose records have no creation date, Created has no effect.
Save and reuse search criteria
At the right end of the panel, the tune icon opens the Saved criteria pop-up. It lists the criteria you have saved, by description, and its Filter items box narrows the list as you type.
- To save the current criteria, click Save search criteria at the bottom of the pop-up, type a Description, and click Save. The description cannot be blank or the same as one you have already saved. A saved entry holds the class, the Search In choice, the field rows, the Created period, and the switches.
- To reuse saved criteria, click the entry. Its criteria are applied at once, and the pop-up closes.
- To delete an entry, point to it, click its Delete cross, and confirm in the Delete criteria dialog.
Saved criteria are your own and are kept with your Web App profile; there is no shared set and no set that an administrator manages. The criteria saved here are listed only here: the search window of a lookup keeps a list of its own.
How your words are matched
- Every word must match. The Web App splits what you type at spaces and finds records that contain all of the words. It has no any-word, exact phrase, or Boolean option.
- Quotation marks keep words together. Text in double quotation marks is
searched as one term instead of as separate words. The term is still not an
exact phrase: it is matched the way a single word is (see below), so on a
field in the full-text index its last word matches words that begin with it.
If a word inside the quotation marks is a common word or NOT, or begins with
(,),+,-,&, or|, the term is matched anywhere in the text on every field. A quotation mark with no closing mark runs to the end of the text. - Operators are ordinary text. AND, OR, and NOT are searched as words like
any other (they can be dropped as common words, see below), and the characters
(,),+,-,&, and|stay part of the word they touch:-toneris searched as the word-toner, not as "without toner". - Word beginnings or any part of the text. On a field that is in the full-text index, a word matches words that begin with it. On any other field, it matches anywhere in the text, even inside a word.
- Common words are dropped. When the search uses full-text search (a searched field is in the full-text index, or the activity log switch is on) and full-text search is available on the database, common words (stop words) are left out of the search. The stop words are those of SQL Server's stop-word list for the language of the database connection. Dropping these words can make a search find more records than you expect. If nothing is left to search for, the search stops with the message Unable to search for this string because it seems to be empty after filtering out the stop words…
Search for an identifier or a number
Five fields hold a single identifier or number: the ID, the barcode, the asset tag, the ticket number, and the serial number.
- In any search other than Everywhere, these fields are matched like any other field (see How your words are matched), so a partial barcode still finds the record. With Frequently-used text fields, the search also finds the record whose ID exactly matches your text once it is trimmed.
- In an Everywhere search, such a field that is not in the full-text index must match the whole value, so a partial barcode does not find the record.
- The ID and ticket number fields are searched only when the text contains a digit. If one of them is the only field searched and your text has no digit, the search stops with the message Your input does not include a number. Enter a number to search in the field name field.
What is searched
Not every class of record can be searched. With Frequently-used text fields, a search over one class searches these fields:
| Class | Fields searched |
|---|---|
| Incidents, Work Orders | ticket number, summary, description, resolution, notes |
| Change Requests, Service Requests, Problems | ticket number, summary, description, notes |
| Assets | asset tag, ID, name, description, notes, barcode, serial number |
| Computers, Hardware | ID, name, description, notes, barcode, serial number |
| All CIs | ID, name, notes, barcode, serial number |
| Software Licenses | ID, name, description, notes, serial number |
| Tracked Software, Library, Networks, Configurations, Products, Consumables, Service Catalog Items, Approval Stages | ID, name, description, notes |
| Documents | ID, name, description, notes, keywords |
| Projects, SLAs, Services, Groups, Vendors, Stock Rules | ID, name, notes |
| Project Tasks | ID, summary, description, notes |
| Contracts | ID, title, description, notes |
| Purchase Orders | ID, PO number, title, notes |
| PO Items | PO number, PO title, description |
| Persons | ID, full name, primary e-mail address, home phone, mobile phone, business phone, first name, middle name, last name, notes |
| Organizations | ID, name, notes, web page |
| Locations | ID, location, notes |
| KB Articles | ID, title, content, notes |
| Announcements | ID, title, content, notes |
| Equipment Reservations, Approval Requests | ID, notes |
A search over All Tickets searches each of the five ticket classes in that class's own fields and lists the results together.
An Everywhere search covers these classes, each in a shorter list of fields:
| Class | Fields searched by Everywhere |
|---|---|
| Incidents, Problems, Work Orders, Change Requests, Service Requests | ticket number, description, summary |
| Software, Networks, Library, Documents, Services, Groups, Configurations, Contracts, Organizations, Service Catalog Items, Locations, Persons | ID, and the record's name, title, location, or full name |
| Computers, Hardware, Software Licenses | ID, name, asset tag, serial number, barcode |
| Assets | ID, name, asset tag, barcode |
| KB Articles | ID, title, content |
Every other class, such as purchase orders, projects, SLAs, and vendors, is not part of an Everywhere search.
Go to a record by its ID
- In the header, click Go To, or press Ctrl+G (Cmd+G on a Mac). The Go To dialog opens.
- In Object ID, type the exact ID or its significant part, or pick one of the suggestions.
- Press Enter or click Open in new tab to open the result in a new browser tab, or click Open in current tab.
What opens depends on how many records match:
- One match: the record opens.
- Two to twenty matches: a list of the matching records opens.
- No match: the message No object with the entered ID has been found. Please check the ID you entered. appears, and the dialog stays open.
Before the lookup, leading characters that are not letters or digits, and trailing characters that are not digits, are removed from what you typed. Go To then looks for the ID as entered. If that finds nothing and the text is only digits, it also tries the number in the ID format of each class. Go To returns at most 20 records, looks only in the classes that have a workflow and that your license covers, and leaves out records you are not allowed to view.
If your browser blocks the new tab, the first match opens in the current tab, even when there were several.
The suggestions under Object ID are the last ten IDs that found a record, newest first. They are kept in your browser.
Ctrl+G opens Go To from any page that has the header, even while you are typing in a text box. A record opened in its own window has no header, and Ctrl+G does not open Go To there. For the other shortcuts, see Keyboard Shortcuts.
Related topics
- Share Links to Records - copy a link to a record you already have open.
- Full-Text Search - how the full-text index that search uses is set up and kept healthy.
- Work on a Ticket
- Configuration Items