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)`

Configuration Management System (CMS)2018.05

How to Filter Discovery Results

This feature describes how to use the UCMDB interface to filter the UCMDB CIs that are discovered.

Configure Filtering in UCMDB

Prerequisites

Before creating a filter, perform an analysis on what information you want to map and what data element in the scan file contains the information you want to filter.
Select a CI to filter
1. Select Adapter Management.
2. In the Resources tree, expand the DDMiInfra node and then expand the Configuration Files node.
3. Right-click GlobalFiltering.xml and select Open in Frame.
4. In the Global Filtering dialog box, click Include or Exclude.
  - Include. All CIs that do not match the filter are removed. If this marker is left empty, all results are sent to the server.
  - Exclude. All CIs that match the filter are removed. If this marker is left empty, all results are sent to the server.
5. Click Select CI Type . The Select CI Type dialog box opens.
  
  Note This option is only available when Include or Exclude is selected in the left pane.
6. Select a CI for which you want to create a filter, and click OK.
Select attributes to filter
1. Click Select Attribute . The Select an Attribute dialog box opens.
2. Select properties for the attribute, and click OK.
Note: You can use the "between" operator when filtering results, but only when the Object class is “ip_address” and the attribute name is “name”.

For details on CI attribute types, see "Attributes Page" in the Modeling section of the UCMDB Help.
Activate and configure settings

In the Global Filtering Configuration Settings pane, select your options.

Available when:Global Filtering Configuration or Include or Exclude is selected in the left pane.
Results

Use the CI Type Manager to verify that data is filtered as expected in UCMDB. For more information, see "CI Type Manager" in the Modeling section of the UCMDB Help.

Global Filtering Dialog Box

Global filtering enables you to filter Probe results for all adapters, so that only results of interest to you are sent to the UCMDB Server.

To access

In Adapter Management, do the following:

In the Resources tree, expand the DDMiInfra node and then expand the Configuration Files node.
Right-click GlobalFiltering.xml and select Open in Frame.

Important Information

Before creating a filter, perform an analysis on what information you want to filter and what data elements contains the information you want to filter.

User interface elements are described below:

UI Element	Description
	Select CI. Opens the Select CI dialog box, enabling you to select a UCMDB CI. Available when: Include or Exclude is selected in the left pane.
	Select an Attribute. Opens the Select an Attribute dialog box, enabling you to add a filter to an attribute for the selected UCMDB CI. Attribute. Select an attribute from the drop down list. Display Label. Name of the attribute. Type. Data type of the attribute as it appears in the CI Type Manager. For more information, see "CI Type Manager" in the Modeling section of the UCMDB Help.
	Enables you to delete the selected UCMDB CI or the attribute.

UI Element

Description

Select CI. Opens the Select CI dialog box, enabling you to select a UCMDB CI.

Available when: Include or Exclude is selected in the left pane.

Select an Attribute. Opens the Select an Attribute dialog box, enabling you to add a filter to an attribute for the selected UCMDB CI.

Attribute. Select an attribute from the drop down list.
Display Label. Name of the attribute.
Type. Data type of the attribute as it appears in the CI Type Manager. For more information, see "CI Type Manager" in the Modeling section of the UCMDB Help.

Enables you to delete the selected UCMDB CI or the attribute.

Global Filtering Configuration Settings

Enables you to activate filtering. It also enables you to define the behavior of filtering.

Important information

These settings apply to all included and excluded filters.

User interface elements are described below:

UI Element	Description
Activate	Enables you to activate filters. Yes. Filters are activated. No.Filters are not activated. Default: Yes
Recursive Filtering	Defines a filtering behavior in which filters are applied to CIs that are linked to CIs that have been filtered. Using global filtering, you can filter out a CI so that it is not included in the filter results. This CI may be a root CI, containing other CIs or relationships. By default, during the filter process, the contained CIs and relationships, as well as any CIs related to them, are added to the filter results—including the root CI. This causes undesired filter results. Recursive filtering corrects this by ensuring that if a root CI is filtered out, then any contained CIs or relationships are filtered out too, such that the root CI cannot be found again. Default: No

UI Element

Description

Activate

Enables you to activate filters.

Yes. Filters are activated.
No.Filters are not activated.

Default: Yes

Recursive Filtering

Defines a filtering behavior in which filters are applied to CIs that are linked to CIs that have been filtered.

Using global filtering, you can filter out a CI so that it is not included in the filter results. This CI may be a root CI, containing other CIs or relationships. By default, during the filter process, the contained CIs and relationships, as well as any CIs related to them, are added to the filter results—including the root CI. This causes undesired filter results. Recursive filtering corrects this by ensuring that if a root CI is filtered out, then any contained CIs or relationships are filtered out too, such that the root CI cannot be found again.

Default: No

Attribute Editor

Enables you to define properties of attributes that you want filtered.

Important information

This page is displayed when an attribute is selected in the left pane.

User interface elements are described below:

UI Element	Description
Operator	Click the drop down to display a list of operator types.
Value	Type a function that is appropriate for the operator type. The function must return a value.

UI Element

Description

Operator

Click the drop down to display a list of operator types.

Value

Type a function that is appropriate for the operator type.

The function must return a value.

Send Help Center feedback