Salesforce

Owned by Juliane Wetzel
Last updated: Jul 27, 2021

INFO

Salesforce is an enterprise cloud computing firm. It specializes in social and mobile cloud technologies, including sales and CRM applications helping companies connect with customers, partners, and employees.

Prerequisites

INFO

Make sure you have your Salesforce instance configured accordingly. Datameer will retrieve the data with an OAuth token - without revealing a username and a password to Datameer X.

Configuring Salesforce as a Connection

  1. Click the "+" button and select "Connection" or right-click in the File Browser and select "Create New" → "Connection". The "New Connection" tab appears in the menu bar.

  2. Select "Salesforce" from the drop-down and confirm with "Next". The type is displayed in the drop-down.

  3. Select the web service protocol to be used from the drop-down.

  4. Enter the host address and the port, where the web service is running on.

  5. Enter the root path.

  6. To authenticate, click on “Authorize Datameer to retrieve data”. You are then taken to the http://salesforce.com portal to generate an OAuth access token for Datameer. The OAuth code is automatically transferred to the appropriate field.

  7. Confirm with “Next”.

  8. If needed, enter a description and confirm with "Next". The 'Save Connection' dialog opens.

  9. Select the folder to save the connection, enter a name in "Save as" and confirm with "Save". The connection is saved. Configuring the Salesforce connection is finished. 

Importing Data with the Salesforce Connector 

Applicable Custom Properties

INFO

You can use custom properties to modify the importing process to your needs.

Custom PropertyExample ValueDefault ValueDescription
datameer.plugin-webservice.read-timeout.ms120000 (~2 minutes)120000
  • sets a HTTP response data read timeout
datameer.salesforce.maxrecords-per-result-request600000determined by the Salesforce API endpoint
  • specifies the maximum number of records within a batch
datameer.salesforce.max-parallel-result-request21
  • specifies the maximum number of batches, that are fetched in parallel

Importing Data with the Salesforce Connector

  1. Click the + (plus) button and select Import Job or right-click in the browser and select Create new > Import Job.     

  2. Click Select Connector, choose the Salesforce connector, and click Next.

  3. Enter a search Salesforce Query (SOQL) and click Next.

  4. Review the defined fields and click Next.

  5. Review the schedule and advanced properties for the job and click Next.

  6. Create a description for the import job and click Save.