Writing a Duplicate Check Plug-In Object

To write a duplicate check object in Aptify, a developer writes code that implements the IAptifyDuplicateCheck interface to define the criteria for absolute and/or potential matches. IAptifyDuplicateCheck is an interface in the Aptify.Framework.BusinessLogic.GenericEntity namespace (see the Aptify Software Development Kit (SDK) for more information on this interface).

Also, the code typically references a stored procedure that contains the match logic. As described in Use Stored Procedures to Retrieve Database Values, Aptify recommends that developers use stored procedures where possible rather than include SQL statements directly within a plug-in object's code.

The IApifyDuplicateCheck interface has two members that serve the following purposes:

• CheckForDuplicates Method: This method is responsible for checking for duplicate records against the data in the pending record within the current GE. Aptify recommends that you use a parameterized data table to provide input values for a stored procedure that contains the matching logic. Based on the data table created by the stored procedure's execution, the method then returns a duplicate check result (None, Potential, or Exact) and the set of Duplicate record IDs.
• DuplicateMessageObject Property: This property identifies the object that corresponds to the duplicate message dialog to display when the CheckForDuplicate method has identified one or more duplicate record matches. To use the standard message box provided by Aptify (whose functionality and appearance is described in Enabling the Duplicate Record Check for a Service), this property should return Nothing. See About the Sample Application Duplicate Check Objects for an example.

This topic contains the following sub-topics:

• About the Sample Application Duplicate Check Objects
• Bypassing the Duplicate Check Process
• Creating a Dupe Check Class

Related topics

• Page:
  About the Baseline Persons and Companies Sample Duplicate Objects
• Page:
  About the Customers Entity Duplicate Check Object
• Page:
  About the Sample Application Duplicate Check Objects
• Page:
  About the Vehicle Models Entity Duplication Check Object
• Page:
  Adding a Duplicate Check Plug-In Object to an Entities Record
• Page:
  Adding Plug-Ins to an Entity
• Page:
  Addressing Absolute Duplicate Records
• Page:
  Addressing Absolute Duplicate Records
• Page:
  Addressing Potential Duplicate Records
• Page:
  Addressing Potential Duplicate Records
• Page:
  Bypassing the Duplicate Check Process
• Page:
  Creating a Dupe Check Class
• Page:
  Developing Duplicate Check Objects
• Page:
  Enabling the Duplicate Record Check for a Service
• Page:
  Enabling the Duplicate Record Check for a Service