Install a Search Client in ServiceNow

This feature is not available in the SearchUnify Cloud Edition.

This article walks you through the process of installing a SearchUnify search client in ServiceNow.

Installation Overview

Prerequisites

  • Activated Customer Service plug-in in ServiceNow
  • SearchUnify user scope set to either "Search" or "All"

Create a Search Client in SearchUnify

  1. Navigate to Search Clients from the menu bar and click Add new search client.
  2. Give your search client a name and enter your ServiceNow instance web address in Base URL.
  3. Click Save.

Note down the UID of the search client that you have just created. It will be used later.

Create an App in SearchUnify

  1. From Apps in the main menu bar, click Create New App.
  2. Give your app a name.
  3. Enter your ServiceNow instance web address appended by api/x_312362_c_a_su/sugetcode in Redirect URL.

EXAMPLE.

https://dev42559.service-now.com will change to https://dev42559.service-now.com/api/x_312362_c_a_su/sugetcode.

  1. Set the scope to Search and press Save.

Note down the Client ID and Client Secret of the app that you have just created. They will be used later.

Install SearchUnify in ServiceNow

  1. Log into ServiceNow.
  2. Using Filter Navigator, find Plugins.
  3. Look up "customer service" in the search box.
  4. Check Customer Service to activate the plugin.

Create a SearchUnify App

  1. Find Studio from the Filter Navigator and click it.
  2. Select Import from Source Control.
  3. Enter https://github.com/searchunify-git/su-service-console in URL.
  4. In User name and Password, enter the credentials that your SearchUnify representative has shared with you.
  5. Click Import.

A app by the name of Customer Application SearchUnify will be created.

Configure the SearchUnify App

  1. Look up "SearchUnify Console" in Filter Navigator.
  2. Click Configure.
  3. Enter Search Client UID, Client ID, Client Secret, and Instance URL and press Submit. (The Instant URL is the web address of your SearchUnify dashboard.)

  4. Press Log in with SearchUnify and then Allow.
  5. Open a case in ServiceNow.
  6. Click , navigate to Developer, and select Customer Service from the Application dropdown.

  7. From , click From Design in Configure.
  8. Drag Search Results Page in Formatters to the Short Description section.

  9. Save.

 

You can reload the case details page to use search.