Configure your Expertise Locator

Configure Your Expertise Locator Pages

  1. Go to the SmartHub Administration page.
  2. Click the "Expertise Locator" link in the left navigation panel
    1. Alternatively you can directly access http(s)://<Smarthub_site_URL>:port/_admin/ExpertiseFinder/default.aspx 


  3. Configure your Expertise search page one of two ways:
    • Recipe Method:
      1. Using an existing recipe:
        1. Cast a role
        2. Find a guru
          or
    • Page Builder Method:
      1. Build the page by specifying your own settings

Model Settings tab

Search Model

For a general purpose Expertise setup, BA Insight recommends using: Entities based on related and Entity Search.

Note: The settings below are stored in a JavaScript file named config.js stored at the SmartHub root level.

Recipe Method

The recipe method is preset for one of two options:

  • Find a guru
  • Cast a role

The configuration options available, as described below, vary slightly, based on which option you select.

  • Entities based on related – Two Stage
    • The user query is used to search among the evidence corpus
    • Experts are derived solely based on evidence
    • This option does return experts that match the user query only by their user profile
  • Entities based on related and Entity Search
    • The user query is used for searching in both:
      • Evidence corpus
      • User profile
    • If at least one matches then the person is recommended as an expert
  • Entities based on related – Two Stage Curated 
    • Similar with Entities based on related – Two Stage above, but does some additional processing on refiners to ensure the user is not shown any refiner options that might produce 0 results
    • This is less performant than Entities based on related – Two Stage because it does one additional query to the search engine
  • Entities based on related – Large pool
    • The user query searches, in order:
      1. User profiles - so that the most important profiles are returned
      2. Content created only by the users returned in step 1
    • Experts are derived from the authors of the documents returned in the second step
  • Simple Entity record search
    • This is simple “People Search”
  • Smart Select
    • Selects one of Entities based on related – Two Stage or Entities based on related – Large pool based on the applied refiners
    • If there are more refiners related to evidence than person then Entities based on related – Two Stage is used
  • Custom Model
    • Enables you to load a custom model.
    • Requires written code. The code .dll file must be loaded.
  • Entity property name
    • Property in the entity query linked to related records
    • Example: People
  • Related property name
    • Property that links related records to the entity query
    • Examples: author, docAuthorAccount
  • Property restriction operator
    • The operator used when creating property restrictions
  • Reduction filter: The mechanism that selects relevant related records
    • Facet reduction:
      • A filter reduction. Counts related records to rank search results.
      • For example, a search for "California labor law," if user Joe has 300 records and user Sally has 50 records, Joe is recommended as the expert.
    • Metadata reduction
      • Related record relevance is used when calculating ranks
    • Customer Filter
      • Custom filter name: Specify a custom filter name from the registered search engine filters
      • Row limit: The max number of related records to be considered
  • Filter Limit
    • The max number of values extracted from related facet.
      Note: A large Filter limit can cause performance issues
  • Entity record result source
    • The result source to pick entity records from



  • Related record result source
    • The result source to pick related records from

Criteria Settings Tab

  • Property: The name of the managed property
  • Role: Specify whether this applies to entity or related records

  • Default property: Select the default priority for criterion

  • Add criterion...: Use this option to add additional properties

Additional Parameters tab

Additional model and filter parameters.

  • Parameter name
  • Parameter value

Query Template

BA Insight recommends you use: Entities based on related and Entity Search for a general purpose Expertise setup.

  1. Make sure the Query template field contains the parameter Federatorsearch engines:"<your expertise search engine name>" .
  2. Make sure the Query template field contains the parameter ExpertiseEntitiessearch engines:"<entity search engine name>;<other entity search engine>"
  3. Make sure the Query template field contains the parameter ExpertiseRelatedRecordssearch engines:"<related records search engine name>;<other related records search engine name>"

Email Template

Depending on your selection (Cast a role/Find a guru), the following information changes slightly.

  • Email subject: the subject line of the email to be sent
  • Email body: the body text to be sent in the email

Create an Expertise Search Page

  1. Enter a page name for your search page.
    1. Also create a landing page.
  2. Click Create page(s) and the file Templates.zip downloads.
  3. Unblock the downloaded file by Right-clicking the .zip file and check "Unblock."
  4. Click OK.
  5. Extract the downloaded archive and paste the extracted files into your SmartHub installation folder at the root level.

Validate the Expertise Locator Installation

  1. Validate your Landing Page.

  2. Go to http(s)://<Smarthub_site_URL>:port/Landing<your search page name>.html:

  1. Check the Search Page: Go to http(s)://<smarthub web site url>/<your search page name>.html:

  1. Check the Tradeoff page: The redirect button from the search page will be visible when at least two refiners have values checked or no Expertise is found for the current query.

How to Upgrade Expertise (move from SmartHub v5.5 to v6.0)

To update from Expertise from v2.0 to v6.0 perform the following steps:

  1. Navigate to the Expertise Search Page Creator.

  2. Generate a new set of Expertise Pages.

  3. Create your own copy of the ExpertiseBaseCustomSettingsTemplate.

    • The file can be found in your SmartHub website root directory under modules/SmartHubResourceLoader

  4. Manually port into the v6.0 settings file each customization found in the v5.5 settings file.

  5. Manually port into the v6.0 HTML file each customization found in the v5.5 HTML file.

  6. Manually port into the v6.0 config file each customization found in the v5.5 configuration file.

Note: If the out-of-the-box template was modified, create a new Content Container template and update the new ExpertiseBaseCustomSettings file with the new template.