dynamicAddress (Use Country-Based Address Field Ordering)

This element specifies that the contents of the AddressBlock MERGEFIELD field shall be dynamically ordered based on the country associated with the current record or if the country-invariant version of the address field shall be used in its place. [Rationale: When a source document is combined with the contents of a data source in order to produce multiple merged documents, it is often necessary to use an address form specific to the destination country for each particular record in the data source, rather than one static address form for all records. end rationale] If this element is set to true, then the mail merge shall use an address form suited to the country associated with the current record in the external data source.

If this element is omitted, then the form of the address shall be dynamically determined based on the country specified in the current record.

[Example: Consider a merged WordprocessingML document that is specified to *not* dynamically create the address field order based on the country associated with the current record. This requirement may be specified using the following WordprocessingML:

<w:fieldMapData>
…
<w:dynamicAddress w:val="off" />
</w:fieldMapData>

The dynamicAddress element is set to a value of off, specifying that the dynamic address format shall not be used when performing a mail merge with the specified data source. end example]

Parent Elements

fieldMapData (§2.14.15)

Attributes

Description

val (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

A value of off, 0, or false specifies that the property shall be explicitly turned off.

[Example: For example, consider the following on/off property:

<w:… w:val="off"/>

The val attribute explicitly declares that the property is turned off. end example]

The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67).

The following XML Schema fragment defines the contents of this element:

</complexType>