active (Record Is Included in Mail Merge)

This element specifies whether a specific record from the specified external data source shall be imported into a merged WordprocessingML document when the mail merge defined for a source document is performed. If this element's val attribute is false, then the record specified by the parent element shall not used to create a merged document.

If this element is omitted for a given record, the data record associated with it shall be imported into a merged WordprocessingML document when the mail merge is performed.

[Example: Consider the following fragment from a source WordprocessingML document that is connected to an external data source containing two records, one of which will not be imported into a merged WordprocessingML document when the conforming hosting application performs the data import.

<w:recipients>
<w:recipientData>
<w:active w:val="false" />
<w:uniqueTag w:val="1126664175" />
</w:recipientData>
<w:recipientData>
<w:uniqueTag w:val="1530576378" />
</w:recipientData>
</w:recipients>

In this XML fragment, the external data record who is identified by the uniqueTag element ( §2.14.35) with a val attribute equal to 1126664175 will not be imported into a merged document as the active element associated with it has a val attribute equal to false. Conversely, the external data record associated with the uniqueTag element with a val attribute equal to 1530576378 will be imported into a merged document, as its active element has been omitted (implying the default value of true). end example]

Parent Elements

recipientData (§2.14.28)

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>