Adding an Entity Plug-In Object to an Entities Record

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

  1. Open the entity's record in the Entities service. (This is the entity for which you created the plug-in.)
  2. Click the Plug-Ins tab.
  3. 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.
  4. Select Entity from the Plug In Type drop-down list.
  5. Click the Object Repository icon in the Object Name field to open the Select Object Repository Object dialog.
    • If your new object is inheriting from an existing plug-in, write down the name and location of the existing object and then clear the Object Name field before clicking the Object Repository icon. You need to keep track of the existing object since you will be adding it as a related object to ensure it is also downloaded each time your plug-in object is downloaded (since your object is dependent upon it).  

      New Plug Ins Record
  6. 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).
  7. Double-click the .NET Assembly (Private Deployment) Object Type.

    Select .NET Assembly Object Type
  8. Click the New button and browse to the location of the entity object's file.
  9. 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 Entity Object
  10. Enter the object's .NET assembly name in the Assembly Name field.
  11. Enter the object's class name in the Class Name field.

    Completed Entity Plug Ins Record
  12. Click OK.
  13. Save and Close the Entities record.
  14. If your new object inherits from an existing Entity Plug-In object (such as a new entity object for the Orders entity), then complete these additional steps to ensure that all relevant objects are also downloaded to an Aptify client when your plug-in is downloaded:
    1. Open the Object Repository Objects record for your entity plug-in object (from the Object Repository Administration service).
    2. Click the Related Objects tab.
    3. Add the plug-in object your object inherits from as a Related Objects sub-type record (this is a link to another Object Repository Objects record). For example, if you created a new entity object for the Orders entity that inherits from the standard AptifyOrdersEntity object, you should specify AptifyOrdersEntity as a related object.
    4. Note that you may also want to add the original Entity Plug-In object (that is no longer referenced on the Plug-In tab) as a Required Object on the entity's Configuration > Required Objects tab for tracking purposes. However, this is not required since the Related Object link on the Object Repository Objects record is sufficient to maintain a link between the objects).

      Specifying Related Objects
  15. If you have referenced any Stored Procedures in the object, add these stored procedures as Database Objects to Aptify, if they do not already exist.
  16. For any Database Objects you created to support the entity object, add links to these objects on the entity's DB Objects tab. This 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 Rental Agreements entity object uses the spGetStatusIDfromName 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.) 

       Add New Database Objects to DB Objects Tab
  17. Close and reopen the Aptify client.
  18. Use the records in the entity to preform a test to confirm that the system successfully uses the logic you defined within the entity object. 
Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.