RaiseExceptionDataListID Attribute

This material pertains to version 3.0 of Blackbaud CRM SDK.

The RaiseExceptions element supports duplicate record checking by providing the ability to call a data list which evaluates whether an exception should be raised when an auto match occurs.

The required RaiseExceptionDataListID attribute represents the data list ID that will be called to evaluate if an exception should be raised.

	<RaiseExceptions RaiseExceptionDataListID="511771b7-d728-4d3f-a5fc-f41069b46e32" 
                       BatchRowFieldID="BATCHROWID" 
                       AutoMatchRecordFieldID="AUTOMATCHRECORDID" 
                       RaiseExceptionColumn="DOMANUALREVIEWFORAUTOMATCH" />
</AutoMatch>

In the sample above, the RaiseExceptionDataListID refers to the "Constituent Update Batch Raise Exception For Auto Matches Data List" which returns a Boolean value indicating if an exception should be raised for the auto matched constituent. Below is the data list. Note the two form fields for the data list parameters which map to the values within the RaiseExceptions element's BatchRowFIeldID attribute and AutoMatchRecordFieldID attribute. Also within the data list, note how the DOMANUALREVIEWFORAUTOMATCH OutputField maps to the RaiseExceptions element's RaiseExceptionColumn attribute. The data list accepts in the parameter values and determines whether to raise an exception by setting the value for the DOMANUALREVIEWFORAUTOMATCH column.