Salesforce Connector Setup

Version 21.0.7964


Salesforce Connector Setup


The Salesforce connector allows you to integrate Salesforce into your data flow by pushing or pulling data from Salesforce’s API. Follow the steps below to connect ArcESB to Salesforce.

Establish a Connection

To allow ArcESB to use data from Salesforce, you must first establish a connection using OAuth login. The connection can be created from either the connector configuration pane or the Connections tab of the Settings page.

Note:

  • The login process is only required the first time the connection is created.
  • Connections to Salesforce can be re-used across multiple Salesforce connectors.

From the Connector Configuration Pane

  1. Drag a Salesforce connector into an ArcESB flow and give it a name.

  2. In the Connector Configuration pane, click + Create next to the Connection drop-down list.

  3. The Add Connection modal appears. Enter a name for the connection and click Connect.

  4. A new window opens for logging into Salesforce. Enter your credentials and log in.

  5. If prompted, grant permissions for ArcESB to connect to Salesforce. You will then return to ArcESB.

  6. Click + Add Connection to finalize the connection.

  7. In the Connection drop-down list of the connector configuration pane, select the newly-created connection.

  8. Click Save Changes.

From the Settings Page

  1. Open the Settings page, and then click the Connections tab.

  2. Click + Add to open the Connection Type modal.

  3. Click Salesforce, then click Next.

  4. Continue from step 3 above for Connection Configuration Pane.

Select an Action

After establishing a connection to Salesforce, you must choose the action that the Salesforce connector will perform. ArcESB can interact with Salesforce in 6 ways. The table below outlines each action and where it belongs in an ArcESB flow:

Action Description Position in Flow
Upsert Inserts or updates Salesforce data. By default, if a record already exists in Salesforce, an update is performed on the existing data in Salesforce using the values provided from the input. End
Lookup Retrieves a value from Salesforce and inserts that value into an already-existing Arc message in the flow.
The Lookup Query determines what value the connector will retrieve from Salesforce. It should be formatted as a SQL query against the Salesforce tables.
Middle
Select Retrieves data from Salesforce and brings it into ArcESB.
You can use the Filter panel to add filters to the Select. These filters function similarly to WHERE clauses in SQL.
Beginning
Execute Stored Procedures Treats data coming into the connector as input for a stored procedure, and then passes the result down the flow.
You can click the Show Sample Data button to provide sample inputs to the selected Stored Procedure and preview the results.
Middle
Upload Uploads documents from the flow into Salesforce. End
Download Downloads documents from Salesforce and passes them down the flow. Beginning