Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  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 in Figure 12.9below, 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.)

      Vehicle Models DB Objects
  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.  

    New Plug Ins Record
  8. Browse to the Object Package for your organization where you want to store the entity object (see "Object and Interface Configurations" in the Developer Guide for 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.

    Select .NET Assembly 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.)

    Select Dupe Check Object
  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.

    Completed Duplicate Check Plug Ins Record
  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).

...