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 A software component that allows seamless integration with third-party services, business applications, and content stores. Examples include Salesforce, Box, and Microsoft SharePoint. Connectors are used to create connections required for workflow actions and start events. 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 lookup
Use the Salesforce data lookup to create a drop-down list of Salesforce issue types, priorities, projects, and users. Each data lookup is configured for a specific account. You can create as manydata lookups as you need. For more information on creating a data lookup and assigning permissions to it, see Data lookups.
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 A form control that allows users to select from a drop-down list of values that have been fetched from a third-party service.. The Data lookup form control uses a Salesforce – Query records data lookup to list the records for a specific Salesforce object type.
You can create a data lookup 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 form 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 lookup fields
When you create a Salesforce data lookup, you can configure some additional fields to specify which companies, contacts, deals, deal pipelines, or owners the data lookup should retrieve.
To access the data lookup fields, in the Add data lookup section, select the Connector and the Operation.
The following operation is 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:
|