Add Salesforce Data

How to add Salesforce Data to an eSpatial Map, Joins, Filtering

Adding Data from Salesforce

With eSpatial it is easy to add your Salesforce data onto a map. eSpatial supports the default Salesforce objects as well as Custom objects and Salesforce Reports.

Add data Options

: eSpatial will default the name to the object name, date and time. Give a meaningful name so that you will know what to expect in this dataset and so that you can reuse this data in other maps. e.g. "My Leads Q1 2018"


Limit to: With this option you decide whether you want to just see the records you own (My Records) or to add all records that you have visibility of in Salesforce. 

Add Filter: Using the "Add Filter" option lets you add criteria to your Salesforce data to filter down the data that you add to a map. This includes filtering on statuses, dates, text and numeric values. 

Salesforce Object Types

The following Salesforce object types are supported by default:

  • Leads
  • Accounts
  • Opportunities
  • Contacts 

Custom Objects

You can map your Salesforce Custom Objects once they have a location element, such as address or coordinates. The location information can either be stored in the Custom Object itself, or in a related object so that you can using the "Add Join" functionality to add in location information. 

Salesforce Reports

If you are looking to add Salesforce reports to your map, you can find help on Salesforce reports here -

Choose Address Columns

Salesforce provides a lot of flexibility to include address information against your records. The two defaults are billing and shipping, but you can also build your own customer address fields. In eSpatial, you can specify which address fields to use. You can also save an address default for your organization so that the next time someone tries to upload data they can use the same settings. 

  • Recommended Org Settings: Once recommended address settings have been made for an object for an org, this will be available as a saved address grouping to select on the left hand side.
  • Billing: Use the Billing Address to map your data.
  • Shipping: Use the Shipping Address to map your data.
  • Custom: Select the fields you want to use to map your data. You can select one or more fields to
    use to map your data.
  • Set As Org Default: Using this option saves your configuration as the default address for this object type for your org. You need to have the eSpatial admin permission to set this.
  • Region: This field allows to you add an additional piece of location information that will be added to every record to help map it. For example, if you did not store Country information and all of your data was included in one country such as Canada, you could include "Canada" in this field to help with the plotting of your data.


Preview: The preview setting lets you preview data for the fields you've used to plot your information. You should use this to make sure that you are not plotting against blank fields or non address data. 


Additional details on data loading

  • If you have updated an object or custom object (for example, you may have added a new field to leads or a custom object or even removed a field), the new fields may not have been picked up when you go to import the data. To view the most up-to-date versions when adding data, you need to do a force refresh on your browser. If using Chrome, press F12 (developer mode), right click on the refresh button, and then choose the empty cache and reload option.