linkToQuery (Query Contains Link to External Query File)

This element specifies that the current WordprocessingML document's query string, stored in the query element (§2.14.26) and used to specify the data to be imported from the external data source, actually contains a reference to an external query file which contains the actual query data to be used against the specified external data source for the mail merge. This query shall mimic a SQL query and be of the following form: SELECT * FROM <query file path>.

If this element is omitted, then the query specified for the data source attached to the current document shall be assumed to not be a query containing a link to an external file.

[Example: Consider a mail merge source document that uses the linkToQuery element to specify that the query used is stored in the specified external data source as follows:

<w:mailMerge>
…
<w:linkToQuery />
<w:query w:val="SELECT * FROM C:\queryExample.txt" />
…
</w:mailMerge>

The linkToQuery element specifies that the query string stored in the query element (§2.14.26) is actually just a reference to an externally stored query file, in this case, an external query file stored at c:\queryExample.txt. 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>