17.14.4 checkErrors

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 can 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: Consider a mail merge whose WordprocessingML definition includes the following:

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

The presence of a checkErrors element with a val attribute of 3 indicates that the hosting application must 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 . end example]

Attributes

val (Decimal Number Value)

Specifies that the contents of this attribute contains a decimal number.

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

[Example: Consider the following numeric WordprocessingML property of simple type ST_DecimalNumber:

  <… 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. end example]

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

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