Salesforce modules
In an Adobe Workfront Fusion scenario, you can automate workflows that use Salesforce, as well as connect it to to multiple third-party applications and services.
For a video introduction to the Salesforce connector, see:
For instructions on creating a scenario, see the articles under Create scenarios: article index.
For information about modules, see the articles under Modules: article index.
- Not all editions of Salesforce have API access. For details, see the information about Salesforce editions with API access on the Salesforce Community site.
- For information on specific errors returned from the Salesforce API, see the Salesforce API docs. You can also check the status of the Salesforce API for any possible service outages.
Access requirements
You must have the following access to use the functionality in this article:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront package | Any |
| Adobe Workfront license |
New: Standard Or Current: Work or higher |
| Adobe Workfront Fusion license** |
Current: No Workfront Fusion license requirement Or Legacy: Workfront Fusion for Work Automation and Integration |
| Product |
New:
Or Current: Your organization must purchase Adobe Workfront Fusion. |
For more detail about the information in this table, see Access requirements in documentation.
For information on Adobe Workfront Fusion licenses, see Adobe Workfront Fusion licenses.
Prerequisites
To use Salesforce modules, you must have a Salesforce account.
Salesforce API information
The Salesforce connector uses the following:
About searching for Salesforce objects
When searching for objects, you can either enter individual search words or create a more complex query using wild cards and operators:
- Use the asterisk wild card (*) as a substitute for zero or more characters. For example, a search for Ca* finds items that start with Ca
- Use a question mark wild card (?) as a substitute for a single character. For example, a search for Jo?n finds items with the term John or Joan but not Jon
- Use the quotation marks operator (" ") to find an exact phrase match. For example: “Monday meeting”
For more information about search possibilities, see the Salesforce developer documentation about SOQL and SOSL.
Create a connection to Salesforce
To create a connection for your Salesforce modules:
-
In any Salesforce module, click Add next to the Connection box.
-
Fill in the following fields:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header Connection name Enter a name for the new connection. Environment Select whether are connecting to a production or non-production environment. Type Select whether you are connecting to a service account or a personal account. Client ID Enter your Salesforce Client ID. Client Secret Enter your Salesforce Client secret. Sandbox Enable this option if this is a Sandbox environment. API Version Enter the version of the Salesforce API that you want to use. The default version is 62.0. -
Click Continue to save the connection and return to the module.
Salesforce modules and their fields
Triggers
Watch a field
This trigger module starts a scenario when a field is updated in Salesforce.
Watch for Records
This trigger module executes a scenario when a record in an object is created or updated. The module returns all standard fields associated with the record or records, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Watch Outbound Messages
This trigger module executes a scenario when someone sends a message. The module returns all standard fields associated with the record or records, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
This module requires some extra setup. There must be a Flow configured for outbound messages.
- For instructions on Flows in Salesforce, see Automate Tasks with Flows in the Salesforce documentation.
- For information on configuring an outbound message in Salesforce, see Send an Outbound Message from Your Record-Triggered Flow in the Salesforce documentation
When you are configuring this module, the following fields display.
Actions
Create a Record
This action module creates a new record in an object.
The module allows you to select which of the object’s fields are available in the module. This reduces the number of fields you must scroll through when setting up the module.
The module returns the ID of the record and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Custom API Call
This action module lets you make a custom authenticated call to the Salesforce API. This way, you can create a data flow automation that can’t be accomplished by the other Salesforce modules.
The module returns the following:
-
Status Code (number): This indicates the success or failure of your HTTP request. These are standard codes that you can look up on the internet.
-
Headers (object): A more detailed context for the response/status code that doesn’t relate to the output body. Not all headers that appear in a response header are response headers, so some might not be useful to you.
The response headers depend on the HTTP request you chose when configuring the module.
-
Body (object): Depending on the HTTP request you chose when configuring the module, you may receive some data back. That data, such as the data from a GET request, is contained in this object.
When you are configuring this module, the following fields display.
Enter a path relative to <Instance URL>/services/data/v62.0/.
For the list of available endpoints, refer to the Salesforce REST API Developer Guide.
{"Content-type":"application/json"}. Workfront Fusion adds the authorization headers for you.{"name":"something-urgent"}Add the body content for the API call in the form of a standard JSON object.
Note:
When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.
Example: The following API call returns the list of all users in your Salesforce account:
-
URL:
query -
Method: GET
-
Query String:
-
Key:
q -
Value:
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
Matches of the search can be found in the module’s Output under Bundle > Body > records.
In our example, 6 users were returned:
Delete a Record
This action module deletes an existing record in an object.
You specify the ID of the record.
The module returns the ID of the record and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Download Attachment/Document
This action module downloads a document or attachment from a record.
You specify the ID of the record and the type of download you want.
The module returns the ID of the attachment or document and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Read a Record
This action module reads data from a single object in Salesforce.
You specify the ID of the record.
The module returns the ID of the record and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Update a Record
This action module edits a record in an object.
The module allows you to select which of the object’s fields are available in the module. This reduces the number of fields you must scroll through when setting up the module.
The module returns the ID of the record and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Upload Attachment/Document
This action module uploads a file and attaches it to a record you specify, or uploads a document.
The module returns the ID of the attachment or document and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Upload File
This action module uploads a single file to Salesforce.
Searches
Search
This action module retrieves all records meeting a given criteria.
Search with Query
This search module looks for records in an object in Salesforce that match the search query you specify. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.