Adding a Duplicate Check Plug-In Object to an Entities Record

After you have built the duplicate check object's assembly file, you need to add it to Aptify as a plug-in. Follow these steps:

1. If you not done so already, add the stored procedure you wrote for the duplicate check object to Aptify by creating a Database Objects record within Aptify.
   • See Creating Database Objects for information on the Database Objects service.
   • When you add a new Database Objects record to Aptify, the system automatically creates the database object in SQL Server.
      
2. Open the entity's record in the Entities service. (This is the entity for which you created the dupe check plug-in.)
3. Click the entity's DB Objects tab and add the Database Objects record for the stored procedure you wrote for the dupe check object.
   • Following this practice ensures that all objects required for the entity to function correctly are referenced within the Entities record. Also, when you use the Entity Packer to pack an entity, the wizard automatically includes any Database Objects referenced on this tab as part of the pack file.
   • In the example below, since the Vehicle Models dupe check object uses the spCheckForVehicleModelMatch stored procedure, this stored procedure has been added to the entity's DB Objects tab. (Note that the Usage field is for informational purposes only and is not required.)
     
     
4. Click the Plug-Ins tab.
5. Open a new Plug Ins sub-type record.
   • If the entity has an existing Entity plug-in and your new object inherits from that plug-in, open the existing Entity Plug Ins record.
      
6. Select Duplicate Check from the Plug In Type drop-down list.
7. Click the Object Repository icon in the Object Name field to open the Select Object Repository Object dialog.  
   
   
8. Browse to the Object Package for your organization where you want to store the entity object (see Best Practices When Configuring Object Repository Objects for information on recommended naming and storing conventions).
9. Double-click the .NET Assembly (Private Deployment) Object Type.
   
   
10. Click the New button and browse to the location of the entity object's file.
11. Select the object you just added and click OK to return to the Plug In form. (The Object Name field is automatically populated with the Object Package.Object Name of the object you selected, as shown below.)
    
    
12. Enter the object's .NET assembly name in the Assembly Name field.
13. Enter the object's class name in the Class Name field.
    
    
14. Click OK.
15. Save and Close the Entities record.
16. Close and reopen the Aptify client.
17. Test the duplicate check object by attempting to save an absolute or partial match to an existing record (based on the match criteria you defined in the stored procedure).

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