<addressFieldName> (Column Containing E-mail Address)

This element specifies the column within a given external data source that contains e-mail addresses. This element is specified independently of the field mappings specified for a given merged document via the <fieldMapData> element (§2.14.15).

If this element is omitted, or no column exists in the data source with this column name, then the source document specifies that no e-mail address data shall be associated with this mail merge.

Note:

This element is independent of the field mapping specified for a given merged document via the <fieldMapData> element (§2.14.15). This separation enables applications to email the documents resulting from the population of WordprocessingML fields with external data regardless of the presence or absence of a field mapped to external data specifying email addresses. ]

<w:addressFieldName w:val="Alternate Email Address" />

The <addressFieldName> element specifies that the Alternate Email Address column contains e-mail addresses for each record. ]

Parent Elements

<mailMerge> (§2.14.20)

Attributes

Description

<val> (String Value)

Specifies that its contents will contain a string.

The contents of this string are interpreted based on the context of the parent XML element.

<w:pPr>
  <w:pStyle w:val="heading1" /> 
</w:pPr>

The value of the @val attribute is the ID of the associated paragraph style's styleId.

However, consider the following fragment:

<w:sdtPr>
  <w:alias w:val="SDT Title Example" />
  ...
</w:sdtPr>

In this case, the decimal number in the @val attribute is the caption of the parent structured document tag. In each case, the value is interpreted in the context of the parent element. ]

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

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

<complexType name="CT_String">
	<attribute name="val" type="ST_String" use="required"/>
</complexType>