Update object

The Update object action updates the object class properties of objects in a data source.


This action node is used to update properties on one or more objects in a data source.

To update many objects at once (a batch update) there are two possible methods:

  1. Use a While or Foreach action node to iterate over the objects. Add an Update object action node inside the iterator action node with the same data source selected and Object in context as the Selection.

  2. Use only the Update object action node. This method is more performant. See the example Batch update in the Examples section below.

When Update object operates on an object it becomes the object in context. This object in context contains the original values prior to the update and these can be accessed using data bindings and functions.

In addition, the values set in the update are available as self-properties. Self-properties are only available in functions. These can be used to update properties that are dependent on the values of other properties that are being updated in the same operation. In other words, a function must be used to access to new value of a property, if that property is updated in the same Update Object operations. See the example Update Object - Self Properties and dependencies below.


In this example, 1 object is updated. The properties Price and Product (reference) of an Order line is updated. As you see, the Price on the Order line is set equal to the price of the Product.

You may use the value processor inside the Update Object action node. For example, to increase a value by 1.



Data Source

Select a data source that contains the object(s) to update.


Available if the selected Data Source is a many-cardinality data source. Define the objects to update.

  • All objects

  • Filtered selection


Values on update

Set new values for any object class properties in the defined object(s).

Last updated