Integration component to connect the Salesforce for the elastic.io platform.
Please Note: The component works with the Salesforce API. This means you must make sure your Salesforce edition has API Access enabled. To check which editions have API access see the Salesforce editions with API Access document. If your edition has no API Access by default this component will not work for you.
The component uses Salesforce - API Version 46.0 by defaults but can be overwritten by the environment variable SALESFORCE_API_VERSION
.
Please note: Deprecated Actions and Triggers - API Version 25.0
Name | Mandatory | Description | Values |
---|---|---|---|
SALESFORCE_API_VERSION | false | Determines API version of Salesforce to use | Default: 46.0 |
REFRESH_TOKEN_RETRIES | false | Determines how many retries to refresh token should be done before throwing an error | Default: 10 |
HASH_LIMIT_TIME | false | Hash expiration time in ms | Default: 600000 |
HASH_LIMIT_ELEMENTS | false | Hash size number limit | Default: 10 |
Please Note: From the platform version 20.51 we deprecated the component
LOG_LEVEL
environment variable. Now you can control logging level per each step of the flow.
The technical notes page gives some technical details about Salesforce component like changelog and completeness matrix.
Authentication occurs via OAuth 2.0.
In order to make OAuth work, you need a new App in your Salesforce. During app creation process you will be asked to specify
the callback URL, to process OAuth authentication via elastic.io platform your callback URL should be https://app.elastic.io/callback/oauth2
.
More information you can find here.
During credentials creation you would need to:
Choose Auth Client
or create the new one.For creating Auth Client you should specify following fields:
Field name | Mandatory | Description |
---|---|---|
Name | true | your Auth Client’s name |
Client ID | true | your OAuth client key |
Client Secret | true | your OAuth client secret |
Authorization Endpoint | true | your OAuth authorization endpoint. For production use https://login.salesforce.com/services/oauth2/authorize , for sandbox - https://test.salesforce.com/services/oauth2/authorize |
Token Endpoint | true | your OAuth Token endpoint for refreshing access token. For production use https://login.salesforce.com/services/oauth2/token , for sandbox - https://test.salesforce.com/services/oauth2/token |
Name Your Credential
Authenticate
button - if you have not logged in Salesforce before then log in by entering data in the login window that appearsVerify
button for verifying your credentialsSave
button for saving your credentialsHere you can see how to select an existing client
:
For more information pleas read our Creating OAuth App for Salesforce article.
Please Note: When you deploy the Salesforce component separately into a dedicated tenant or into your developer team it can not use the OAuth App specifically created for our main elastic.io tenant. For this purposes you must create a different OAuth App and add the required environment variables to the component setup.
Salesforce component includes the following triggers:
Query trigger Continuously runs the same SOQL Query and emits results one-by-one. Use the Salesforce Object Query Language (SOQL) to search your organization’s Salesforce data for specific information.
Get New and Updated Objects Polling trigger Polls existing and updated objects. You can select any custom or built-in object for your Salesforce instance.
Subscribe to platform events This trigger will subscribe for any platform Event using Salesforce streaming API. Realtime flows only.
You can find information on deprecated triggers here.
Use this list to navigate to the action you seek.
Query action Executing a SOQL Query that may return many objects. Each resulting object is emitted one-by-one. Use the Salesforce Object Query Language (SOQL) to search your organization’s Salesforce data for specific information.
Create Object action Creates a new Selected Object. Action creates a single object.
Delete Object action Deletes an object by a selected field. One can filter by either unique fields or all fields of that sobject.
Upsert Object action Creates or Updates Selected Object. Action creates a single object.
Lookup Object action(at most 1) Lookup an object by a selected field. Action creates a single object.
Lookup Objects action Lookup a list of objects satisfying specified criteria.
Bulk Create/Update/Delete/Upsert action Bulk API provides a simple interface for quickly loading large amounts of data from CSV file into Salesforce.
Bulk Query action Fetches records to a CSV file.
You can find information on deprecated actions here.
Attachments mechanism does not work with Local Agent Installation
Get your free 14-day elastic.io trial account to use this component.