XFA Specification
Chapter 15, Template Specification
Template Reference
621
The setProperty element
An element that causes a property of the container to be copied from a value in the XFA Data DOM or from
data returned by a web service.
<setProperty
Properties:
connection="cdata"
ref="cdata"
target="cdata"
>
</setProperty>
The setProperty element is used within the following other elements:
draw exclGroup field proto subform
The connection property
Optionally supplies the name of an associated connection to a web service. When this is supplied and
non-empty the
ref
The ref property
Supplies a pointer to the data to be copied. This is a SOM expression with the restriction that it cannot
contain the string "..". It may be a relative SOM expression. If there is no associated web service then the
expression is interpreted relative to the enclosing container. If there is an associated web service then it is
interpreted relative to the nearest ancestor that asserts a fully-qualified SOM expression as its value of
ref
for the same connection.
The target property
A SOM expression identifying the property to be set. The expression is evaluated relative to the container.
The target must be a property or subproperty of the container.
Almost any property of the container can be the target of this element. However the copying is done near
the end of the data merge process. For some properties it is too late because the property has already had
its effect. Also it is not recommended to use this element to set the
value
property of a field or exclusion
group; use an explicit data reference instead.