<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: 
<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). ]

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.

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

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

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 name="CT_OnOff">
	<attribute name="val" type="ST_OnOff"/>
</complexType>