<name> (Data Source Name for Column)

This element specifies the column name within a given external data source for the column whose index is specified via the <column> element (§2.14.7). This data source name provides a column name which shall be used to map a specific MERGEFIELD field in the document, as specified by the parent field mapping data. The @val attribute specifies the name of this column in the data source when the connection is initially established, which is then used permanently to link columns in the database to MERGEFIELD fields in the document.

If this element is omitted, no data source name is provided for the current column.

example: 
<w:fieldMapData>
  …
  <w:name w:val="first" />
  <w:column w:val="0" />
</w:fieldMapData>
<w:fieldMapData>
  …
  <w:name w:val="middle" />
  <w:column w:val="1" />
</w:fieldMapData>
<w:fieldMapData>
  …
  <w:name w:val="last" />
  <w:column w:val="2" />
</w:fieldMapData>

The WordprocessingML above demonstrates that the column name first shall be associated with the first column in the external database by specifying a <column> element with its @val attribute equal to 0. In addition, the column name middle shall be associated with the second column in the external database by specifying a <column> element with its @val attribute equal to 1. Finally, the column name last shall be associated with the third column in the external database by specifying a <column> element with its @val attribute equal to 2. ]

Parent Elements

<fieldMapData> (§2.14.15)

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>