setProperty

Allows a new value to be set for a property of an existing variable. Generally entries of Maps and Map-like variables, such as Data Items, are considered properties, whose values this command can change.

Attributes

target
Required	Value type	EL-evaluated
Yes	String	No
The resolved String should be an EL-expression specifying the property whose value is to be changed.

value
Required	Value type	EL-evaluated
No	Any	Yes
Defines the new value for the property specified with `target`.

required

Required

Value type

EL-evaluated

No

Boolean

No

If this attribute resolvesinto true, the value attribute resolving into null produces an error.

If not defined, value of false is used.

Examples

The setProperty command can generally be used as an alternative to addMapEntry If the goal is to give new values to existing keys in a Map. Have the target attribute specify a key of the Map to set that entry's value.

CODE

<setProperty target="${contactMap.address}" value="${newAddress}"/>

In addition to Maps and their kin, some other value types also have "properties" - such as Files. One could use setProperty to change the title of a File value:

CODE

<setProperty target="${composedDoc.title}" value="The Composed Document"/>