Understanding Advanced Search and Syntax Rules

Document created by Yum Darling Administrator on Mar 16, 2018Last modified by Yum Darling Administrator on Mar 20, 2018
Version 3Show Document
  • View in full screen mode

Samanage allows you to use the Search field to search for free text or to search by any property, such as those related to, but not limited to:

  • Incidents, Service Catalog Items, Problems, Changes, Release, Solutions etc. 


Search Behavior

By default, the search will match the whole term. If needed, wildcard searches can be used (? replaces a single character, and * replaces zero or more characters).


Exact Phrase Matching
When you want to find words that are near each other, for example: “quick brown fox” or “AB-DFG250-MALTA”
The search query will show only results that contain all of the search terms, in the same positions relative to each other.


Use Properties:  

  • name: Find a specific Incident Name (for example name:keyboard, or name:"keyboard")
  • number:  Find a specific Incident Number or any other Object number (for example number:4444 or just search the number by itself)
  • tag:  Search throughout the object’s tags


In addition the following properties can be used:

  • description, department, user, type, category, status, variables, manufacturer, serial, ip_address, mac_address

Note: the properties must be written in lower case


Boolean Operators

The preferred operators are + (this term is part of the search) and - (this term is excluded from the search).

For example, this query:
quick brown +fox -news

means that:
fox must be present
news must not be present
quick and brown are optional — their presence increases the relevance



Multiple terms or clauses can be grouped together with parentheses to form sub-queries. 

The following is an example of how to use and/or combination to search for incidents under the UK site where the description is either UAT or Workaround.
(description: UAT OR description: Workaround) AND site: UK

Note: the "AND" and "OR" conditions must be written in capital letters


Number Ranges

Inclusive ranges are specified with square brackets [min TO max] and exclusive ranges with curly brackets {min TO max}.

For example, to search for all incident numbers between 4000 and 4400:

number:[4000 TO 4400]


Reserved Characters

If you need to use any of the characters which function as operators in your query itself but not as operators, then you can escape them with a leading backslash. For instance, to search for (1+1)=2, you would need to write your query as \(1\+1\)\=2.

The reserved characters are: + - = && || > < ! ( ) { } [ ] ^ " ~ * ? : \ /


Dedicated to your success,


Your Samanage Team

3 people found this helpful