Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

CMS UI2018.05

How to Define Discovery Rules

This task describes how to define a new discovery rule in the Discovery Rules Engine.

If you are working on an upgraded version of UCMDB, you can also edit user-defined rules from your previous version.

To learn more about the Discovery Rules Engine, see Discovery Rules Engine Overview.

To add new user-defined discovery rules:

Go to Adapter Management.
In the Resources pane, click New , and select New Configuration File.

Enter a name for the new discovery rule. The name must begin with ruleEngine/ and end with .xml.

For example: ruleEngine/myRule.xml.
In the Package field, select NormalizationRules.
In the Editor pane that opens on the right, enter the new rule.

An example of valid rules can be found under NormalizationRules > Configuration Files, in ruleEngine/samples.xml.
Click OK.

To edit an existing discovery rule from a upgraded version of UCMDB:

Go to Adapter Management.
In the Resources pane, select the UserDefinedRules package.
Under Configuration Files, select the .xml file for the rule that you want to edit.
Note
- Rules that were defined in previous versions of UCMDB (for example in oidToHostClass.xml), can be found under the UserDefinedRules package, in the configuration file UserDefinedOidToHostClass.xml.
- Out-of-the-box OidToHostClass rules can be found under NormalizationRules > External resources in the ruleEngine/snmp.gz file.