Configuring Enhanced Search

The Search capability in the Self Service Mobile portal functions beyond a simple search where the results are displayed based on the weight assigned to the Business Object fields. This helps in displaying better and accurate results the user is looking for.

However, this feature has to be specifically configured for user roles having access to the Self Service Mobile portal.

If no fields are configured for the Enhanced Search, by default, the application will consider the fields that are configured in the Edit Preview section with equal weights.

Prerequisites:

1.Raise a Service Request to the Ivanti Operations team to enable the Enhanced Search feature.

2.After the Enhanced Search feature is enabled, setup the following Global Constants:

•SearchIndexAge and KnowledgeArticlesAge - allows to limit the search to the defined age of the documents and records. For example, if the limit is set to 6 months, then the search will display results of documents and records that are not older than 6 months. The default value is 6 and 12 months respectively, change the values as per your requirement.

•SearchFieldWeightRowLimit - allows to set the number of fields and its weight range. If the value is set as 5, then you can add 5 fields. The default value is 10. For more info, see Sample Scenario.

•SearchAutoCorrect - set the value as True to enable auto correcting spellings of search keywords. By default it is set to False.

For example,

• If SearchAutoCorrect is True - if you search for Moble, the application corrects the spelling to Mobile and displays results for the corrected spelling.

•If SearchAutoCorrect is False - if you search for Moble, the application simple displays results for Moble without making any spelling correction.

• ElasticSearchUpdateAsync - set the value as True to enable asynchronous indexing of documents in Elasticsearch for enhanced search.

Configuring fields:

The Enhanced Search feature won't be functional just by configuring it. For it to be functional, raise a Service Ticket to Support to get it activated and ensure you specify the role for which it should be activated in the Service Request.

1.Log in to Neurons for ITSM as an Administrator.

2.Open the Configuration console.

3.Navigate to Users and Permissions > Roles and Permissions.

4.Select Top Level Tabs > Search.

5.In the Search for matches section, click Edit Config under the Search Config column for the Business Object you wish to configure.

The Search Config column will be available only if the Enhanced Search feature is enabled.

6.Add fields and assign weights ranging from 1 to 10.

The number in the Weight field is relative, it helps set priority to the fields and display results based on the set priority.

Sample scenario:

a. Click Edit Config for the Knowledge Business Object.
b. Click the icon, set the Field as Title and Weight as 2.
c. Click the icon again, set the Field as Description and Weight as 1.

 

Configuring search for Knowledge Business Object fields

The maximum number of fields you can add depends on the value set in the SearchFieldWeightRowLimit Global Constant.

d. Click Save.

Based on the above configuration, when a search is performed in the Knowledge Business Object, the search results displays results having the keyword in the Title on the top followed by the keyword in the Description since the Weight defined for the Title is higher than Description.

For example, if there are two documents present in the Knowledge Business Object, where one document has the word Laptop in the Title and in the other it is in the Description. If you search for Laptop in the Knowledge Business Object, in the results displayed, the document with the word Laptop in the Title will be displayed first and then the one in the Description as the search algorithm emphasizes the word Laptop in the Title more than the Description due to a higher weight assigned to Title.

7.Repeat step 6 for as many Business Objects as required. For example, you can configure search for FAQs, Service Request, and Task.

The above steps are applicable for configuring the Enhanced Search for fields when adding new Business Objects as well. Ensure the required Preview and Filter configurations are added.

8.Once the setup is done, click Save in the Top Panel.

9.After saving the setup, raise a Service Request to Support to activate the Enhanced Search configuration. Ensure you specify the role which should be activated in the Service Request. This step is mandatory for both new and modified search fields.

Only after the Support team activates, the Enhanced Search is functional.