17.14.24 name

This element specifies the column name within a given external data source for the column whose index is specified via the column element (17.14.6). 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: Consider a source document that is connected to an external data source with three columns. Within this external data source, these are three columns are ordered and titled as follows: first, middle, and last, respectively. The following WordprocessingML specifies that when this document was connected to the data source, these columns were ordered in this manner:

<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 must 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 must 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 must be associated with the third column in the external database by specifying a column element with its val attribute equal to 2. end example]

Attributes

val (String Value)

Specifies that its contents contain a string.

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

[Example: Consider the following WordprocessingML fragment:

  <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 nearest ancestor structured document tag. In each case, the value is interpreted in the context of the parent element. end example]

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

[Note: The W3C XML Schema definition of this element’s content model (CT_String) is located in A.1. end note]