salesforce Say hello to Einstein GPT
Contact Us 1-800-664-9073
  1. Homepage
  2. DataWeave
  3. DataWeave Reference
  4. Values (dw::util::Values)

  5. update

This version of the product has entered Extended Support. You can switch to the latest version, or use the version selector in the left navigation.

update

DataWeave 2.2 is compatible and bundled with Mule 4.2. Standard Support for Mule 4.2 ended on May 2, 2021, and this version of Mule will reach its End of Life on May 2, 2023, when Extended Support ends.

Deployments of new applications to CloudHub that use this version of Mule are no longer allowed. Only in-place updates to applications are permitted.

MuleSoft recommends that you upgrade to the latest version of Mule 4 that is in Standard Support so that your applications run with the latest fixes and security enhancements.

update(Object, String): Any

This update function updates a field in an object with the specified string value.

The function returns a new object with the specified field and value.

Parameters

Name Description

objectValue

The object to update.

fieldName

A string that provides the name of the field.

Example

This example updates the name field in the object {name: "Mariano"} with the specified value.

Source

%dw 2.0
import * from dw::util::Values
output application/json
---
{name: "Mariano"} update "name" with "Data Weave"

Output

{
  "name": "Data Weave"
}

update(Object, PathElement): Any

This update function updates an object field with the specified PathElement value.

The function returns a new object with the specified field and value.

Parameters

Name Description

objectValue

The object to update.

fieldName

A PathElement that specifies the field name.

Example

This example updates the value of a name field in the object {name: "Mariano"}. It uses field("name") to return the PathElement that it passes to update. It uses with "Data Weave" to specify the value (Data Weave) of name.

Source

%dw 2.0
import * from dw::util::Values
output application/json
---
{name: "Mariano"} update field("name") with "Data Weave"

Output

{
  "name": "Data Weave"
}

update(Array, Number): Any

Updates an array index with the specified value.

This update function returns a new array that changes the value of the specified index.

Parameters

Name Description

objectValue

The array to update.

indexToUpdate

The index of the array to update. The index must be a number.

Example

This example replaces the value 2 (the index is 1) with 5 in the the input array [1,2,3].

Source

%dw 2.0
import * from dw::util::Values
output application/json
---
[1,2,3] update 1 with 5

Output

[
   1,
   5,
   3
 ]

update(Array, String): Any

This update function updates all objects within the specified array with the given string value.

Parameters

Name Description

objectValue

The array of objects to update.

indexToUpdate

A string providing the name of the field to update.

Example

This example updates value of the role fields in the array of objects.

Source

%dw 2.0
import * from dw::util::Values
output application/json
---
[{role: "a", name: "spiderman"}, {role: "b", name: "batman"}] update "role" with "Super Hero"

Output

[{
   "role": "Super Hero",
   "name": "spiderman"
 },
 {
   "role": "Super Hero",
   "name": "batman"
}]

update(Array, PathElement): Any

This update function updates the specified index of an array with the given PathElement value.

The function returns a new array that contains given value at the specified index.

Parameters

Name Description

objectValue

The array to update.

indexToUpdate

The index of the array to update. The index must be specified as a PathElement.

Example

This example updates the value of an element in the input array. Notice that it uses index(1) to return the index as a PathElement, which it passes to update. It replaces the value 2 at that index with 5.

Source

%dw 2.0
import * from dw::util::Values
output application/json
---
[1,2,3] update index(1) with 5

Output

[
   1,
   5,
   3
 ]

update(Array | Object | Null, Array<String | Number | PathElement>): Any

Updates the value at the specified path with the given value.

Parameters

Name Description

objectValue

The value to update. Accepts an array, object, or null value.

path

The path to update. The path must be an array of strings, numbers, or `PathElement`s.

Example

This example updates the name of the user.

Source

%dw 2.0
import * from dw::util::Values
output application/json
---
{user: {name: "Mariano"}} update ["user", field("name")] with "Data Weave"

Output

{
   "user": {
     "name": "Data Weave"
   }
 }

update(Null, Number | String | PathElement): Any

Helper function to make update null friendly.

View on GitHub