Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Excerpt

Salesforce federated search is a simple integration of an existing Squirro project into the default search of Salesforce. No installation of a Salesforce App is required.

...

1. Enable the Opensearch API in Squirro

Section
bordertrue


Column
width50%
  1. Identify the project id of the Squirro project you want to integrate into Salesforce via federated search.
  2. Generate a non-admin, read-only user for this project. Generate an API token for this user.
  3. Add a configuration section to /etc/squirro/frontend.ini with the following content:
    Code Block
    languagetext
    [opensearch_api]
    # Whitelist all project ids that expose the opensearch API.
    # Only configure projects here that contain public data as of today we have no
    # authentication in place.
    # Multiple projects can be separated by comma.
    project_ids = abc...
    
    # use a read-only api token for a non-admin user.
    token = abc...
    
    #query cache time in seconds
    query_cache_ttl = 60


  4. Restart the frontend service
  5. Navigate to the settings page of the configured project
  6. Click on the 'Opensearch API' Studio Plugin link on the left
  7. Click on the 'GO TO DESCRIPTION XML' button
  8. Copy the URL of the description xml file. You'll need this for setting up Salesforce.


Column
width50%

Image Added


Image Added



2. Configure Federated Search within Salesforce

  1. Login to Salesforce and go to Setup
  2. Type 'External Data Sources' into the search box and select it.
  3. Click 'New External Data Source'
  4. Give it a Label and a Name. Select 'Federated Search: OpenSearch' as Type
  5. Enter the copied description xml URL from step 8 above into the field 'OpenSearchDescription URL'
    Image Added
  6. Click 'Save'
  7. Click 'Validate and Sync' on the next page
    Image Added
  8. Select your datasource in the table and click 'Sync'
    Image Added
  9. You're done, all Squirro items are now searched as well if you do a search within Salesforce standard search