Salesforce Opportunity Search integration

The Opportunity Search integration provides a portal into your Salesforce environment, allowing you to search for existing opportunities in your Salesforce instance, and view any notes, attachments or activities associated with it.

The Salesforce Search Opportunities widget on a page.

Sections in this article:

Limitations

  • Only English language use is supported in the Opportunity Search integration.
  • Salesforce imposes API limits “per user per hour” which may result in some users unable to access this widget at certain times.

Enabling CORS

Salesforce integration widgets require CORS to be enabled in your Salesforce instance. To enable:

  1. Log in to Salesforce as an administrator.
  2. On the top-right corner of the page, select Setup.
  3. Select Administration Setup.
  4. Select Security Controls.
  5. Select CORS.
  6. Enter the URL of your digital workplace.
  7. Select Save.

Set up

  1. Place an  Integrations widget on a page, space, or dashboard. For more information, see Placing and setting up a widget
  2. Select the placed widget's Edit button.
  3. Under Integration Library, select Igloo Integration Library.
  4. Select  Salesforce Opportunity Search from the library.
  5. Review and make changes to the settings on the Options and Appearance tabs. You can find details about the widget's settings in the Settings section below.
  6. In the widget editor, select Update to apply your changes.
  7. At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.

Settings

Options tab

Setting Description
Title

Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections.

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a title for each supported language. 

This field can contain a maximum of 140 characters.

Title link

Enter the URL of a location in your digital workplace. Users who click the widget's title, if it has one, will go to this location. Whether you enter the link as a relative URL or an absolute URL does not matter, it will convert to an absolute URL the next time you edit the widget.

This field can contain a maximum of 2,083 characters.

Description

Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a description for each supported language.

General options
Setting Description
Salesforce Instance Type

Select the type of Salesforce instance that you are connecting to. Options include:

  • Production
  • Sandbox
Basic configuration options
Setting Description
Salesforce Instance URL Enter the URL of your Salesforce instance.
Page Size for Notes Enter the maximum number of notes and attachments to show in the list.
Page Size for Activities Enter the maximum number of activities to show in the list.
Search Placeholder Text Enter the default text that appears in the search bar before you start typing.
Default Tab

Select which tab the widget shows when the page is loaded. Options include:

  • Open Activities
  • Closed Activities
Widget Layout Order

Select a layout. Options include:

  • Activities, Notes & Attachments
  • Notes & Attachments, Activities
Advanced options

Appearance tab

Appearance options
Setting Description
Class

Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets.

Height

Select the height of the widget.

The default value is Auto (leftmost slider position) scales the widget's height to fit its contents. You can use the slider to set a fixed height between 50px to 600px in increments of 50px.

Selecting a height less than what is needed to display its contents results in the widget having a vertical scrollbar.

Note

Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.

Using it

The Salesforce integration widgets provide many of the features available in the Salesforce web interface:

  • Search opportunities: The primary feature of this widget is a search bar in which you can enter opportunity names. It will return a quick result which you can select to open the notes, attachments, and activities associated with that opportunity
  • View activities: Selecting an opportunity will display a list of activities with the same features and options available in the Salesforce Activities integration.
  • View notes and attachments: Selecting an opportunity will display a list of activities with the same features and options available in the Salesforce Notes and Attachments integration.