<destination> (Merged Document Destination)

This element specifies what the result which shall be generated when a mail merge is carried out on a given WordprocessingML source document. In other words, this element is used to specify what is to be done with the merged documents that result from populating the fields within a given merged WordprocessingML document with data from the specified external data source.

If this element is omitted, then the default destination of merged documents shall be assumed to be of type newDocument.

Note:

For example, if a given merged WordprocessingML document contains a <destination> element with its @val attribute equal to email, the hosting application may surface a user interface specific to creating emails with the data resulting from populating fields within a given merged WordprocessingML document with external data from the specified external data source. WordprocessingML only provides a flag (via the <destination> element) to tell the hosting application to surface this user interface. ]

<w:mailMerge>
  <w:destination w:val="newDocument" />
  …
</w:mailMerge>

The <destination> element's @val attribute is set to newDocument, specifying that when the mail merge is carried out, the source document shall be used to generate a specified number of new documents, which may be handled as appropriate. ]

Parent Elements

<mailMerge> (§2.14.20)

Attributes

Description

<val> (Mail Merge Merged Document Type)

Specifies the type of merged documents which shall be the result of carrying out a mail merge on a given source WordprocessingML document.

<w:destination w:val="email" />

This specifies that a given merged WordprocessingML document will be used by the hosting application to generate e-mails containing the static contents of the merged document as well as external data populated into mapped fields. ]

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

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

<complexType name="CT_MailMergeDest">
	<attribute name="val" type="ST_MailMergeDest" use="required"/>
</complexType>