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

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.

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

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

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>