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.
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:
- Log in to Salesforce as an administrator.
- On the top-right corner of the page, select Setup.
- Select Administration Setup.
- Select Security Controls.
- Select CORS.
- Enter the URL of your digital workplace.
- Select Save.
Set up
- Place an
Integrations widget on a page, space, or dashboard. For more information, see Placing and setting up a widget.
- Select the placed widget's Edit button.
- Under Integration Library, select Igloo Integration Library.
- Select
Salesforce Opportunity Search from the library.
- 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.
- In the widget editor, select Update to apply your changes.
- 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 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 |
Setting | Description |
---|---|
Salesforce Instance Type |
Select the type of Salesforce instance that you are connecting to. Options include:
|
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:
|
Widget Layout Order |
Select a layout. Options include:
|
Appearance tab
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.