Salesforce
Salesforce is a customer relationship management (CRM) suite that offers applications with a focus on sales and support. In the context of Nintex Automation Cloud, Salesforce is a connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores. and is used to create connections for Salesforce actions. For more information on Salesforce, see the company website.
Use Salesforce actions to create, retrieve, update, delete, and query records and to attach and retrieve files from records in Salesforce.
The Salesforce connections Credentials and other settings required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store. you use with Nintex Automation Cloud must be associated to Salesforce organizations with API access. See the Salesforce editions with API Access knowledge article for more information.
Before you start:
The Salesforce connections Credentials and other settings required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store. you use with Nintex Automation Cloud must be associated to Salesforce organizations with API access. See the Salesforce editions with API Access knowledge article for more information.
Jump to:
Create a Salesforce connection
Note: Your browser-stored credentials are accessed to create connections. Either clear credentials from browser memory or make sure the stored credentials are for the intended environment.
-
Salesforce allows each connected app five unique approvals per user. After five connections are created for the same Salesforce user, the first connection is revoked. For more information, see Salesforce help.
-
The access policies configured in Salesforce define for how long a refresh token is valid. Nintex recommends changing the Refresh Token Policy in your Salesforce connection to Refresh token is valid until revoked or Expire refresh token if not used for and set the number of days. For more information, see Salesforce help.
-
The Salesforce user used by the connection needs to have object and field-level security configured in their Salesforce profile so that they have permission to execute Salesforce actions. For example, to use the Salesforce - Delete a record action, the integration user for the Salesforce connection will need delete permission in Salesforce. If you do not want to grant your Salesforce user read, create, and edit rights, you can configure another Salesforce user to serve as an integration user who does have these rights. Salesforce permissions are always enforced.
Create a connection from the connections page or from the action configuration panel when configuring the action. For information about creating connections and assigning permissions, see Manage connections.
In the Add a new connection section, complete the fields as follows:
In this field |
Select or enter the following |
---|---|
Connector | Salesforce Sales Cloud |
Connection | A user-friendly name for your new connection |
Endpoint Address |
For a custom domain (sandbox or development), enter the URL; for others, use the default value of https://login.salesforce.com. |
Create a Salesforce data source
Use the Salesforce data source to create a drop-down list of Salesforce issue types, priorities, projects, and users. Each data source is configured for a specific account. You can create as many data sources as you need. For more information on creating a data source and assigning permissions to it, see Data sources.
For example, to allow users to select a specific Account or Customer in a form, add a drop-down list of records to the form using a Data lookup control. The Data lookup control uses a Salesforce – Query records data source to list the records for a specific Salesforce object type.
You can create a data source for the following:
-
For Query records, list all records for a specific Salesforce object type. You can add conditions to limit the returned query results.
-
For Object name, select the object type from the drop-down.
-
Enter the maximum number of records to return.
-
For Fields, select one or more fields to be used in the form configuration.
-
Conditions are optional. You can configure this field later when used with the Data lookup control.
-
For Sorting, select the field and order that the records are to be returned.
-
For Sort nulls to last, select if records with null values for the Sort by attribute to the end of the sorted results.
-
Salesforce data source fields
When you create a Salesforce data source, you can configure some additional fields to specify which companies, contacts, deals, deal pipelines, or owners the data source should retrieve.
To access the data source fields, in the Add data source section, select the Connector and the Operation.
The following operations are available for the Salesforce connector:
-
Salesforce - Query records
Operation |
Field or selection |
Description |
---|---|---|
Salesforce - Query records | Connection | Lists the available Salesforce connections. |
Object name | The object type of the records you want to query. Accepts a selection from the drop-down list. Options in the drop-down list are derived from the selected Salesforce connection. | |
Maximum number of records to return | Highest number of records to be returned from the queried object. | |
Fields | The list of fields that you want to fetch from the selected Salesforce object. | |
Conditions |
Conditions: Conditional statement(s) to use for the query:
|