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

Service Manager9.41

Integrate > Service Manager integration methods and tools > BDM Mapping Management > Customizing BDM mapping configuration

Customizing BDM mapping configuration

System Administrators can define key-value pairs that can be shared by SM callbacks and BDM callbacks in BDM mapping records. With this functionality, administrators only need to update these key values in one place instead of in individual callbacks.

To customize BDM mapping configuration:

Log in to the Windows client as a System Administrator.
Click System Administration > Ongoing Maintenance > BDM Mapping Management.
In the Version field, select a value. For example, 1.2.
Click Search. The mapping record incident is displayed.
Select the Configuration tab. A two-column table is displayed. This table defines key-value pairs that can be used in BDM mapping callbacks.
- Name: Defines the name of a key to be used in callbacks.
- Value: Defines the value of the key.
Out-of-box, there are three keys: Host, Port, and AppName.
Type key-value pairs in the table. For example, you can type values for the following out-of-box keys:
- Host: abc.domain.com
- Port: 8080
- AppName: webtier-9.30
To view an out-of-box example of using these keys:
1. Select the Field Mapping tab, and locate the SM Object Field named affected.item.
2. In this field section, locate the row in which the BDM Object Field/Attribute value is: affects/configuration_item/smns:drilldown_url
3. Click the BDM Callback in the same row, right-click it and then select Magnify.
  
  The callback code displays in a pop-up text window.
4. Find the following strings, which contain the three out-of-box key names.
```
- $ctx.getMappingConfiguration()['Host']
```
```
- $ctx.getMappingConfiguration()['Port']
```
```
- $ctx.getMappingConfiguration()['AppName'])
```
To use a defined key in a callback:
1. Select the Field Mapping tab, click a callback in the SM Callback or BDM Callback column. Right-click the callback and select Magnify.
  
  The callback code displays in a pop-up text window.
2. Edit the callback code using the following syntax:
  
  $ctx.getMappingConfiguration()['Host'], where Host should be replaced with your key name.
3. Click Save and Close.
To test the values you have defined for the out-of-box keys:
1. Send a REST request by launching this URL in a web browser: http://<SM_serverHost>:<Port>/SM/7/rest/1.2/incident_list/reference_number/IM10002.
  
  A login window is displayed.
2. Type a valid Service Manager username/password (for example, System.Admin/blank password), and click OK.
  
  The REST request response is displayed.
3. Locate this string: <smns:drilldown_url>http://<hostname>:<port>/<AppName>/index.do, where <hostname>, <port>, and <AppName> should be replaced with the values of Host, Port, and AppName, respectively.

Send Help Center feedback