Modify Any Object (Salesforce) v3.0.12 Help
Modifies the record for any object type in Salesforce.
How can I use the Step?
You can use the Step to automate updating existing records in Salesforce. The Step lets you modify specific record fields without manual entry. This way, you save time and reduce errors, ensuring accurate and up-to-date records.
How does the Step work?
You authorize the Step, specify the record you want to modify, and change desired field values. The Step takes these inputs and requests the Salesforce API to update the existing record (see Output example).
Once the record is modified, you can find it in the list view for the selected object type. Alternatively, you can search for the record or find it in the related list of the parent record.
Prerequisites
Before you get started, you must do the following:
- Obtain the
Consumer Key
andConsumer Secret
of the Salesforce Connected App you want to authorize the Step with. For more information about creating and configuring a Connected App, see Create a Connected App documentation.
Authorization
To authorize the Step, you can inherit authorization from a previous Step, select existing authorization or create a new one.
Here are the steps to create a new Salesforce authorization:
For Select authorization in the current Step, choose the
Create a new authorization
option from the dropdown.In the Add an authorization popup, do the following:
For Your Connected Apps, select an existing Connected App or click
Add a new Connected App
and provide the required details in a popup:- Name this Connected App: Connected App name.
- Environment: Environment choice for the Connected App in Salesforce. Either production or sandbox.
- Consumer Key: Consumer Key for Connected App in Salesforce (see Prerequisites).
- Consumer Secret: Consumer Secret for Connected App in Salesforce (see Prerequisites).
- Callback URL: OAuth 2.0 redirect URL. You must use it as Callback URL when creating Connected App on Salesforce.
Name your new authorization.
Choose where to save the authorization.
Authorize the Step by clicking Authorize now or pasting the authorization URL into a web browser.
Once the Step is authorized, all related settings are automatically updated, and you can continue with the Step settings.
Object information
To set up this section, follow these steps:
- For Object Type, select the object type of a record you want to modify. After the Step is authorized, the list of available object types is automatically loaded.
- For Object, select the record to modify.
- Select the fields to modify and enter the new values.
- Optional: Click Load all existing values, to populate selected fields with existing values.
To learn more about Salesforce objects and fields, see Overview of Salesforce Objects and Fields.
Advanced settings
You can use this section to configure the following parameter:
- API version: The Salesforce API version for requests. The value must be in the format
50
or50.0
and contain at least two characters. The default API version is 50, and the minimum supported version is 22.
Merge field settings
The Step returns the result as a JSON object and stores it in the Merge field variable. So you can use the retrieved data in subsequent Steps or other Flows.
Output example
The output includes the data object with the record fields you changed in the Object information section.
{
"data": {}
}
{
"data": {}
}
Error Handling
By default, the Handle error toggle is on, and the Step handles errors with a separate exit. If any error occurs during the Step execution, the Flow proceeds down the error
exit.
If the Handle error toggle is disabled, the Step does not handle errors. In this case, if any error occurs during the Step execution, the Flow fails immediately after exceeding the Flow timeout. To prevent the Flow from being suspended and continue handling errors, you can place the Flow Error Handling Step before the main logic or your Flow.
Reporting
After the Step completes, it generates a report that includes its execution status and other details. You can customize the report by adjusting the Step's log level and adding tags.
Log level
By default, the Step's log level matches that of the Flow. You can change the Step's log level by selecting an appropriate option from the Log level dropdown.
Tags
Tags provide a way to classify and search for sessions based on their attributes. To create a new tag, specify its category, label, and value. You can then use tags to filter and group the sessions in the report.
Service dependencies
- flow builder v2.28.3
- event-manager v2.3.0
- deployer v2.6.0
- library v2.11.3
- studio v2.64.1
- authorizer 2 service v2.1.6
- salesforce data provider
Release notes
v3.0.12
- Add API version selection to the Step UI
v3.0.11
- Add an ability to get default options for the Object type field and the default list of fields for the selected object type through the provider when using dynamic collection authorization.
v3.0.10
- Update the Salesforce Object Fields Builder component
v3.0.9
- Update Authorization Manager v1.2.10
- Add an alert if an error occurs in API requests
v3.0.8
- Update UI tooltips
- Update error handling
- Remove extra data
v3.0.7
- Implement Authorization Manager v 1.1.0
- Remove
dynamicAll
switch handling - Add Step migration
v3.0.4
- Update Authorization Manager v1.0.5
- Add dynamic
instance_url
v3.0.3
- Update Authorization Manager v1.0.4
v3.0.1
- Update the
toJSON
function and wildcard logic with the new Merge field expression template