mailAsAttachment (Merged Document To E-Mail Attachment)

This element specifies that, after importing external data into fields to generate a series of destination WordprocessingML documents as e-mails, the resulting documents should be emailed as an attachment rather than the body of the actual e-mail.

If this element is omitted, then its value shall be assumed to be false (i.e. the destination source is not an e-mail attachment). If the destination element (§2.14.11) specifies that the merged document destination is not email, then this element shall be ignored.

[Example: Consider a merged WordprocessingML document that has been connected to an external data source containing three records and that contains the following WordprocessingML in its mail merge properties as follows:

<w:mailMerge>
…
<w:destination w:val="email" />
<w:mailAsAttachment />
…
</w:mailMerge>

After the external data has been imported into the merged document's respective merge fields, three emails will be generated (as specified by the destination element (§2.14.11) with a val attribute of email, each an attachment consisting of one of the three documents resulting from the mail merge result (rather than just including the merged document as the body of the email). end example]

Parent Elements

mailMerge (§2.14.20)

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>