Setting Up and Managing Federated Search

  • Updated

This article provides instructions to set up Demandbase as an external data source for Salesforce federated search.

Note: The federated search feature is supported only in Salesforce’s Lightning edition. It is available for Salesforce Enterprise, Professional, Unlimited, and Developer licenses.

Prerequisites

In order to use federated search, a custom domain must be configured in your Salesforce instance. If the custom domain exists, go to the Configuring Federated Search section below.

To set up a custom domain for your Salesforce instance, follow these steps:

Step Description Details
1 Go to Setup Log in to Salesforce with admin user credentials and click Setup as shown below:

1_setup.jpg

2 Go to My Domain page Enter domain in the search box and select My Domain option under Company Settings.

2_my_domain.jpg

3 Register your domain In the My Domain page, enter your preferred domain name and click Check Availability.

3_available_small.jpg

Once you enter the desired domain name, click Register Domain.

4_register_small.jpg

Note: Custom domain registration might take some time. Refresh the page to view progress.

4 Deploy the custom domain Once your domain is registered, click Log in to deploy your domain.

5_login.jpg

After you log in, the My Domain page opens. Click Deploy to Users to make the custom domain available for all users.

6_deploy_small.png

Configuring Federated Search

Once you have configured a custom domain, follow these steps to install the Demandbase Unified package and configure federated search.

Step Description Details
1 Install the Demandbase package

To install Demandbase Unified package, follow the instructions in the Installing Demandbase in Salesforce CRM article in our Knowledge Base.

2 Configure authentication URL for Sandbox If you are setting up Federated Search in a Salesforce Sandbox instance, follow these steps to configure the authentication URL:
  • Go to Setup Identity  Auth Providers.
  • Edit InsideView.
  • Enter the following URL in the Authorize Endpoint URL field: https://login.insideview.com/oauth/login/v2/authorize?authHint=SALESFORCE_OAUTH2_SANDBOX&authType=oauth2&prompt=login

    edited_URL_small.png

  • Click Save.

Note: If you are setting up Demandbase Federated Search on a Production environment, this step is not needed.

3 Authenticate the External Data Source To authenticate Demandbase External Data Source, follow these steps:
  • Click the Settings icon at the top of the screen and select the Setup option.

    1_setup.jpg

  • In the Setup page, enter External Data Sources in the Search bar and click the Search icon.
  • Select the External Data Sources option from the search results to view all third-party data sources available for your Salesforce instance.

    6_eds.jpg

  • Select the InsideView external data source as illustrated below:

    7_iv_eds_small.jpg

  • In the External Data Source page, click Edit.

    8_edit_eds_small.png

  • In the External Data Source Edit page, select the Search results visible to all profiles and Start Authentication Flow on Save check boxes.

    9_edit_and_save_small.jpg

  • Click Save. You will be redirected to the Salesforce login page. Log in with your admin user credentials to authenticate the Demandbase external data source.
  • Click Allow and grant permission to the following items:
    • Access your basic information
    • Access and manage your data
    • Perform requests on your behalf at any time

      10_allow.png

4 Validate and Sync Once the authentication process is completed, the External Data Source page opens. Verify that the Authentication Status has changed to Authenticated.

11_v_and_s_small.jpg

Click Validate and Sync.

In the Validate External Data Source page, select the InsideView Accounts and InsideView Contacts check boxes and click Sync.

12_sync.jpg

Note: The sync process might take some time to complete. In case you receive a time out error, click Sync again. If you receive a timeout error again, follow the instructions in “Time limit exceeded” Error in our Knowledge Base to resolve this issue.

Once the sync is completed, InsideView Accounts and InsideView Contacts will be listed under External Objects on the External Data Source page as illustrated:

13_complete_small.jpg

5 Add Demandbase custom tab To configure Demandbase custom tab, follow the instructions in the Configuring Demandbase in Page Layouts and the Custom Tab in Salesforce Lightning Edition article in our Knowledge Base.
6 Use federated search To use the Demandbase federated search, open any Salesforce app in App Launcher and enter your search keyword on the Salesforce search bar. To learn more tips and tricks on how to use federated search, read the Search Tips article in our Knowledge Base.