Setting search configuration parameters

In the Mid Tier interface, as an administrator, use the Server Group Configuration form of the AR System Management Console to view and set search configuration parameters. The configuration parameters are available in the Setting configuration parameters in BMC Helix ITSM.

These parameters do not affect search in Mid Tier.

To set search configuration parameters

In a browser, enter the following URL address:
https://<midTierServerInstallDir>/arsys/
Log in to Mid Tier.
Select AR System Management Console > AR System Server Group Console > Server Group Configuration.
The Server Group Configuration page is displayed.
In the Work On Component Type field, select com.bmc.arsys.smartit.
In the For These Components field, select an option to display component on the screen.
In the Showing These Settings field, select an option to display settings on the screen.
Click Load Settings.
The Global Settings and Local Settings tables are populated with settings and values.
Review and set the configuration parameters described in the following sections.

Search configuration parameters

You can set the configuration parameters that control different searches in BMC Helix ITSM: Asset Management.

Assets displayed in search results in Smart Recorder

You can configure the number of assets that are displayed in the search results. By configuring the following parameter:

Parameter	assetSearchQueryLimit
Default parameter value	Minimum - 4 Maximum - 20
Description	If you specify a number greater than 20 or smaller than 4, the system defaults to the default value of 4.

You can configure the following parameter to restrict asset searches in Smart Recorder to display only the assets related to the selected customer:

Parameter	restrictAssetSearchToCustomer
Default parameter value	false
Description	If you set the value to true, when service desk agents search for an asset in the Smart Recorder, they find only those assets that are related to the selected customer.

Number of CIs displayed in search results on a change request

You can set the following parameter to configure the number of CIs that are displayed in the search results when service desk agents search for a CI to relate to a change request:

Parameter	maxAllowedCiSearch
Default parameter value	0
Description	If you don't change the default value of 0, the search is not limited. For performance reasons, you can set a value to limit the number of CIs displayed in the search results.

Wildcard use in global search

You can configure the global search to skip the use of wildcard % at the beginning of the search value by configuring the following parameter:

Parameter	skipWildcardInGlobalSearch
Default parameter value	true
Description	If you enter % at the beginning of the search value, the system automatically removes the % and displays the search result according to the value that you entered. Skipping wildcard searches avoids generating long-running searches, reduces the time required to display the search result, and provides a good user experience. For example, if you enter %mail, the system automatically removes % and displays the result for the keyword mail. If you set the parameter to false, the system displays the search result with the % wildcard. For example, you enter %mail in the search box. The system displays all search results with any text that has mail in it, such as email and gmail. Note that regardless of this setting, you can add wildcard in the middle or end of the search keyword. For example, if you enter Email ser% is down, the system displays results that have words such as server, service, and so on. If you enter Email %vice is down in the search box, the system displays results that have words such as service, device, and so on.

Search based on first name and last name

You can configure the following parameter to search for people by entering the name in the sequence lastname firstname, along with entering the name in the sequence firstname lastname.

Parameter	reversefirstNameLastName
Default parameter value	false
Description	Change this value to true if you want to search with lastname firstname. If the value is set to true, an additional clause is added in the query to search by lastname firstname along with the firstname lastname.

You can configure the following parameter to enable search with a wildcard between first name and last name.

Parameter	allowPersonSearchByNameOnly
Default parameter value	false
Description	Use this configuration parameter to set the name-based query. You can configure this parameter to true to enable search by firstname%lastname.

Smart Recorder search by company

Set this parameter so service desk agents can search for assets and people on the basis of the #company accelerator when they are creating tickets in Smart Recorder.

Parameter	smartRecorderSearchByCompany
Default parameter value	false
Description	If a service desk agent has access to only one company, only records for that company are displayed for selection. If this parameter is set to false, when service desk agents create tickets in Smart Recorder, people and assets are searched in the context of the company to which the logged-in service desk agent has access.

Typeahead for search

You can configure the following parameter to specify how many characters a service desk agent must enter before Smart IT starts searching for information.

Parameter	CustomizationTypeaheadLength
Default parameter value	3
Description	Based on this default value, BMC Helix ITSM: Asset Management starts searching after a service desk agent types the default of three characters.

Enable or disable typeahead in the global search by configuring the following parameter:

Parameter	disableTypeaheadInGlobalSearch
Default parameter value	false
Description	By default, suggestions are displayed as you type text in the global search. To disable the search suggestion, set this parameter to true.

Additional configuration parameters available in the global settings ( * ) of the com.bmc.arsys.smartit component

Configuration parameters	Default value	Description
templateSearchBy AuthoringGroup	false	If you set this parameter to true, Service agents can select the appropriate template quickly from the filtered list of templates that belong to their support groups.
useLeadingSearchForAsset	true	This configuration parameter determines whether a wildcard (%) is to be appended to asset search text.
useLeadingSearchForperson	true	This configuration parameter determines whether a wildcard (%) is appended to people search text.
affectedCISearch ByAssetPeopleRelation	false	Assets and services that are affected due to the reported incident or that are related to the incident are specified in the Affected Asset and Affected Service fields on the incident profile. It helps the service desk agent look for a specific asset and service, and take action to resolve the incident. For example, Asset1 and Business service1 belong to Company A and Asset2 and Business service2 belong to Company B. If the affectedCISearchByAssetPeopleRelation property is set to false, when a user creates or edits an incident where the user is the affected customer, in the Affected Asset and Affected Service fields, the search result displays Asset1 and Business service1. If the affectedCISearchByAssetPeopleRelation property is set to True, when a user creates or edits an incident where the user is the affected customer, in the Affected Asset and Affected Service field, the search result displays only Asset1 and Business service1 and Business service2. For more information, see Enabling affected assets and affected services for incident
obo.enabled.for.all	false	Use this parameter so that service agents can create service requests on behalf of customers. You can set the value to true for better system performance.
obo.search.prefixWildcard	true	Use this configuration parameter is used to determine whether a wildcard (%) is to be appended to the customer contact search that a service agent performs when creating a service request on behalf of a customer. You can set the value to false for a better performance.