Exclusion Property Name

The value in this field determines whether the XML element is included when the BOD is built:

• If no property name is specified here, the XML element is included.
• If the property name specified here contains a value, the XML element is included.
• If the property name specified here contains no value (is null), the XML element is not included.

In the Replication Document Elements form, you can define XML elements with a null value. This is valid in some cases, for example, a parent XML element that contains a child XML element with a value. In other cases, however, it is better (or required) to exclude the element from the BOD, rather than include the element without a value. You can conditionally exclude an element by defining its Exclusion Property Name, as explained above. The most common case for excluding an element is when the defined property name for the element contains a null value; thus, there is no value to publish in the element. In that case, you can choose to copy the property name to the exclusion property name.

You can specify the same exclusion property name for more than one Replication Document Elements record.

The XML element is excluded only when the BOD has an actionCode attribute value of Add or Replace. The actionCode attribute is found on the ActionCriteria/ActionExpression element of every BOD.

For more information, see The Exclusion Property Name in BOD definitions.