3.1.2.1.1.6 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 be 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:hash w:val="1126664175" />
   </w:recipientData>
   <w:recipientData>
     <w:hash w:val="1530576378" />
   </w:recipientData>
 </w:recipients>

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

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

 <complexType name="CT_OnOff">
   <attribute name="val" type="ST_OnOff"/>
 </complexType>