Update Records
The Update Records activity updates the specified record with the field values you provide. You can update records on context objects, related objects, unrelated objects, and record collection variable data. This activity has two outcomes: Done and Fault.
- Done: Indicates that the update was successful.
- Fault: Indicates that the update failed.
The Fault outcome allows you to decide what actions to take if the update fails. It is triggered only if the database update operation fails. Under the Fault outcome, you can add activities such as sending an email or connecting it to another activity, like iterating through a loop.
- Group: Data
- Nature: Non-Blocking
Example:
When a contract is signed, the system automatically updates its status from "Pending Signature" to "Signed" using the Update Record activity. The flow triggers upon signing, updating the contract and possibly related records. If the update is successful, the flow proceeds with other actions, such as sending notifications. If it fails, an email alert is sent, and the system either retries or moves to another step, ensuring the contract status is updated and errors are managed.
Properties, Entry Criteria and activity information
Properties represent the values used to perform the operations of an activity and Entry Criteria serve as conditions that determine whether an activity should be executed.
|
Field |
Description |
|---|---|
| Details | |
| Display Name | Enter the name of the activity. |
| Reference Name | Enter the technical name of the activity. If left blank, the system automatically generates it based on the value in the Display Name field. The generated name removes special characters, eliminates spaces, avoids consecutive underscores, and joins words with a single underscore. |
| Description | Provide a description that is relevant to the activity. |
| Properties | |
|
Select Type to find records to Update and Set their Values |
Select the type to identify the records or related records you want to update and set their values. Based on your selection, the system displays the remaining input elements on the screen.
Note:
The system can fetch and update up to 2,000 records based on the specified criteria. |
|
Object |
Search and select the context object containing the records you want to update. |
|
Related Object |
Search and select the related object containing the records you want to update. |
|
Variable Name |
Search and select the variable. This variable's data is stored in the database and was created using the Get Records Activity. It can hold either a single record or a list of records from a specific object. This activity will update the data for both types in the database. |
|
Criteria |
Set the conditions to narrow down the list of returned records.
To add more conditions, click Add Criteria. To remove all conditions, click Remove All. |
|
Fields to Update | Specify fields and their values to update: You can populate field values manually or use dynamic values to automatically apply data. Place your cursor in a value text box, and the system's Intellisense capability will suggest options. The suggestions provided by Intellisense are specific to the data type of the field you are configuring. You may see options such as Picklist Values, Variables, Constants, and fields from the Context record. Sample: Manual Entry for Complex Data Types
For Lookup and RecordOwner fields, Intellisense provides suggestions for Identifier and Reference fields, allowing you to directly link records. For example: Automatically create a new Agreement record and link it to its parent Account record whenever specific trigger conditions are met.
|
|
Entry Criteria | |
|
Entry Criteria |
Set the conditions to narrow down the list of returned records.
To add more conditions, click Add Criteria. To remove all conditions, click Remove All. |
| Switch to New Entry Criteria | You will see this toggle only when editing an activity in an existing workflow. Enabling this toggle upgrades the activity to the new IntelliSense Criteria Builder and migrates the old criteria. If the migration fails, you must correct the criteria for a successful conversion or continue using the older version indefinitely. Once switched, you cannot revert to the older Criteria Builder. |
|
Filter Expression |
By default, the application applies AND logic to all criteria. You can adjust this to create more complex logical expressions if needed. You can customize your logic using parentheses, AND, OR, and NOT. For example, if you enter “(1 AND 2 AND 3) OR 4”, the system will evaluate whether all three of the first conditions are true, or if the fourth condition is true. |
