<checkErrors> (Mail Merge Error Reporting Setting)

This element specifies the type of error reporting which shall be conducted by an application when performing a mail merge against the specified source data.

The type of error reporting implied by this element shall be defined as follows:

  • Simulate the population of fields with mapped external data and report errors in a new document if the @val attribute is equal to 1.

  • While populating fields with mapped external data, pausing to report each error as it occurs if the @val attribute is equal to 2.

  • Populate fields with mapped external data and report errors in a new document if the @val attribute is equal to 3.

  • Application-defined behaviors may be used if the @val attribute is equal to any other value.

If this element is omitted, or its value is set to a value outside of those specified below that is not understood by the hosting application, then its value shall be assumed to be 2.

example: 
<w:checkErrors w:val="3" />

The presence of a <checkErrors >element with a @val attribute of 3 indicates that the hosting application shall conduct the type of error reporting specified above, performing the mail merge, populating fields with mapped external data and reporting errors in a new document . ]

Parent Elements

<mailMerge> (§2.14.20)

Attributes

Description

<val> (Decimal Number Value)

Specifies that the contents of this attribute will contain a decimal number.

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

<w:… w:val="1512645511" />

The value of the @val attribute is a decimal number whose value must be interpreted in the context of the parent element. ]

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

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

<complexType name="CT_DecimalNumber">
	<attribute name="val" type="ST_DecimalNumber" use="required"/>
</complexType>