Download PDF
Download page Update Records.
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 |
---|---|
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.
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 | Manually enter the Variable Name to update its value by referring to the Get Records activity. 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. |
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. |
Criteria Expression | Displays the criteria expression based on the selected field, operator, and value condition. You can also specify the criteria in Liquid expression format to write conditions based on the current context object fields. To access the liquid expression editor, click the icon and select the Expression option. |
Fields to Update | Specify fields and their values to update: Field: Select the field you want to update. You can choose from all available fields in the context or related object. Value: You can either manually enter the field data or use dynamic values based on variables or formulas. Place the cursor in the text box, and the system will suggest options based on the field's data type.
To add more fields, click Add. To remove all fields, click Remove All. |
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. |
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. |
Criteria Expression | Displays the criteria expression based on the selected field, operator, and value condition. |
Common | |
Name | Enter the technical name of the activity. |
Display Name | This field auto-populates but can be changed if needed. |
Description | Provide a description that is relevant to the activity. |