Skip to content

Revenue Grid Widgets: Personalized Per-User Setup and Admin User Setup

3 min read

 

This article is an addition to the main RG Email Sidebar Widgets setup article. It describes two special configuration scenarios:

 

Individualized Widgets Setup on Per-User Basis

RG Email Sidebar widgets that can be added to Salesforce interface:

 

To Configure RG Email Sidebar Widgets in Salesforce

The prerequisite for configuring RG Email Sidebar Widgets for a Salesforce user account is to install Revenue Grid managed package for the Salesforce Org. Follow the instructions in this article to configure the prerequisites.

After My Domain was configured and RG managed package was set up, proceed to Salesforce configuration steps below.

 

Tip

Please perform the following steps most accurately, since a mistake here is likely to result in misconfiguration errors

 

1. Set up tenant URLs

For setting up tenant URLs, the Salesforce Admin needs RevenueGridTenantUrl and ServerSyncTenantUrl. To generate RevenueGridTenantUrl and ServerSyncTenantUrl required for RG Managed Package configuration, you can either contact our Support team or follow the instructions provided in the section below.

Important

Depending on your license, the appearance of your Sync Settings page may be different. Below you can find instructions on how to generate tenant URLs on the New and Legacy Sync Settings pages. Proceed with the steps according to the appearance of your Sync Setting page:

 

Generate tenant URLs on the new Sync Settings page

  • Open RG Email Sidebar, click the ☰ Menu button, go to Sync settings




  • Next, the Revenue Grid Sync Settings page will open. Find the address bar at the top of the page


  • Select the address starting with https and ending with .com.
    Ignore everything after .com


The selected address is your RevenueGridTenantUrl.

  • To generate ServerSyncTenantUrl add the “-sync“-part to the address before .revenuegrid.com and the slash ( / ) after .com


In the very end, you should get the URLs that follow this pattern:

  • RevenueGridTenantUrl
    https://[ your tenant ].revenuegrid.com

  • ServerSyncTenantUrl
    https://[ your tenant ]-sync.revenuegrid.com/

Important

Make sure there is a slash / character at the end of the ServerSyncTenantUrl value and there is no slash / character at the end of the RevenueGridTenantUrl value. Otherwise, the users won’t get Revenue Grid Widget content with no issue cause indication

 

 

Generate tenant URLs on the legacy Sync Settings page

  • Open RG Email Sidebar, click the ☰ Menu button, go to Sync settings

  • Next, the Revenue Grid Sync Settings page will open. Find the address bar at the top of the page

 

  • In the address bar, you’ll see the address of the page. Select the address starting with http and ending with .com/. Ignore everything after .com/

 

The selected address is your ServerSyncTenantUrl.

  • To generate RevenueGridTenantUrl remove the “-sync”-part from the address and the slash ( / ) after .com
    In the very end, you should get the URLs that follow this pattern:

  • RevenueGridTenantUrl
    https://[ your tenant ].revenuegrid.com

  • ServerSyncTenantUrl
    https://[ your tenant ]-sync.revenuegrid.com/

Important

Make sure there is a slash / character at the end of the ServerSyncTenantUrl value and there is no slash / character at the end of the RevenueGridTenantUrl value. Otherwise, the users won’t get Revenue Grid Widget content with no issue cause indication

 

How to set up tenant URLs
  • Switch to Lightning Experience as described in this Salesforce article
  • Open Salesforce Setup settings
  • In the Quick Search field type “Custom Settings”
  • Click Manage button next to the CanvasAppSettings label; press Ctrl+F to find it quickly if the list is big

 

  • Find the settings RevenueGridTenantUrl and ServerSyncTenantUrl, then click Edit to modify them:

 

  • Update RevenueGridTenantUrl with a specific RG tenant URL

  • Update ServerSyncTenantUrl with a specific RG tenant URL

Important

Make sure there is a slash / character at the end of the ServerSyncTenantUrl value and there is no slash / character at the end of the RevenueGridTenantUrl value. Otherwise, the users won’t get Revenue Grid Widget content with no issue cause indication

 

 

2. Set up user authorization

  • Switch to Lightning Experience as described in this Salesforce article
  • Click the Gear (Setup Menu) icon in the upper right-hand corner of the page to open Salesforce Setup menu
  • In Quick Search type “App Manager”
  • Click Manage next to InvisibleSuite App that has a Type Connected (Managed)

 

Tip

In case you cannot find the needed item InvisibleSuite - Connected (Managed) on the list, sort the list by Developer Name and look for Revenue Grid for Salesforce

 

  • On the next page, click Edit Policies
  • Set the value Admin approved users are pre-authorized in the picklist Permitted Users

 

  • Click Save to apply configuration updates

 

 

How to Configure Contact, Lead, or Opportunity Widgets for a Salesforce Admin User Account

 

If you configure the widgets for a regular Salesforce user account, the steps provided in this article are sufficient; however, for a Salesforce Admin user extra configuration steps are required to setup the widgets for other users in their org.

Note

The same procedure is used for Contact, Lead, or Opportunity records’ layout adding in Salesforce user interface. The steps are identical

 

1. Switch to Lightning Experience, as described in this Salesforce article. Go to Contact, Lead, or Opportunity tab in navigation pane

2. Click the Gear (Setup Menu) icon in the upper right corner of the page to open Salesforce Setup menu

3. Select Edit Page in the menu

 

After you get to the Lightning App Builder page, you can modify the page’s layout to include Revenue Grid widgets.

4. Scroll to the bottom of the list in the pane on the left to get to Visualforce item

5. Click Visualforce and drag-and-drop this item to the central area:

>>> Click to see a screenshot <<<

 

6. Set the functionality for this particular frame emerging from Revenue Grid by selecting the necessary widget from the drop-down list “Visualforce Page Name” (1). The selected widget will appear in the Visualforce component on the page (2)

>>> Click to see a screenshot <<<

 

You may add as many Visualforce frames as you require, the limit is the number of Revenue Grid widget blocks available in the picklist above.

7. After completing the widget Setup click Activation in the upper right-hand corner

 

8. In the dialog that appears, switch to App, Record Type, And Profile

9. Click the Assign to Apps, Record Types, and Profiles button:

 

10. Select the Apps that you want to add Revenue Grid Widgets to; most often these are Sales and Sales Console

11. Click Next

 

12. At the next page, keep the default Form factor values Desktop and phone and click Next in the bottom right-hand corner

 

13. Select the checkbox Master and click Next

 

14. Select applicable profile types. Usually, these are Standard User and System Administrator. After that click Next

>>> Click to see a screenshot <<<

 

15. Review the sepcified values and click Save button to apply configuration updates

 

16. Click Save in the upper right corner of the “Lightning App Builder” page to save configuration updates

 

17. Return from “Lightning App Builder” to the Contact, Lead, or Opportunity tab by clicking the 🡨 (Back) icon in the upper left corner

 

Back to top