If you have a comment on this topic, contact Aptify Documentation. If you want to return to the Aptify Community Site, please click here.

Adding Plug-Ins to an Entity

An organization can configure an entity to use a specially designed form or specialized functionality. To implement this specialized behavior, a developer creates a .NET assembly that defines the entity's extended functionality. These assemblies are then stored in the Object Repository and are added to the entity on the Plug-Ins tab using the Plug Ins record. The entity uses the plugins specified on this tab to override standard functionality with the functionality specified in one or more plug-ins.

Plug In Types

The Entity Plug In Types service stores the list of available plug-in types. Plug-in types may be global or entity-specific. A developer can create additional Plug In Types as necessary. See About the Entity Plug In Types Form for more information.

The standard Aptify installation includes seven global types as well as a number of entity-specific types:

  • Viewer (1): This plug-in type corresponds to an alternate data form for the entity. In Aptify, entities with specialized viewer forms include Views, Entities, Archive Runs, Scheduled Tasks, and Base Fields.
  • Entity (2): This plug-in type indicates that the object implements specialized business logic for the entity. Typically, this plug applies to entities that require additional functionality beyond the standard implementation. For example, the Views, Entities, Archive Runs, Scheduled Tasks, and Base Fields entities all have an Entity plug-in.
  • Duplicate Check (3): This plug-in type corresponds to an object that implements entity-specific duplicate checking behavior.
  • Extension (4): This plug-in type corresponds to an object that implements an entity-specific right-click context menu.
  • Verification (5): This plug-in type corresponds to an object that implements entity-specific record verification behavior.
  • Find (6): This plug-in type corresponds to an object that implements an entity-specific Find dialog.
  • Merge (7): This plug-in type corresponds to an object that implements -entity-specific record merging behavior.
  • Excel Integration (37): This plug-in type defines the Excel Export wizard for the entity and overrides the default Excel Integration logic specified in the Views entity (or the core Excel Integration component if a default integration plug-in is not specified in the Views entity). You can also define a default configuration for all views within Aptify using the Excel Integration Default plug-in type of the Views entity. See the Using the Excel Integration Wizard for more information.
  • Data Pack: This plug-in defines the Data Pack wizard for the entity and overrides the default packing logic.
  • Data Unpack: This plug-in defines the Data Unpack wizard and overrides the default unpacking logic.

Step-by-Step Instructions

Once a developer has created the plug in, follow these steps to add the new plug-in to an entity:

These steps describe how to add a plug-in to an entity after a developer has created the .NET assembly; these steps do not describe how to write a plug-in. Aptify provides information on creating entity plug-ins in the Developers training course. Students in this course gain first-hand experience creating entity plug-ins in a test environment. Contact Aptify for more information. Additional developer information is also available in the Aptify Software Development Kit (SDK).

  1. Add the plug-in's object file to the Object Repository.
  2. If the plug-in provides functionality that is not already described by an existing plug-in type, create a new record in the Entity Plug In Types service as directed by the plug-in's developer.
    • In general, any new Entity Plug In Types records you create should be specific to a particular entity.

  3. Open the entity's record in the Entities service.
  4. Click the Plug-Ins tab.
  5. Open a new Plug Ins sub-type record.
  6. Select the Plug In Type from the drop-down list.
  7. Enter the Object Repository location of the plug-in's object in the Object Name field.
    • Alternatively, you can click the plus (plus) icon to the right of the field to open the Select Object Repository Object dialog. You can use this dialog to browse for an existing object or to add a new object to the repository (if you have not done so already). See Creating Object Repository Objects for details.

  8. Enter the plug-in's .NET assembly name in the Assembly Name field.
  9. Enter the class within the .NET assembly that implements the plug-in's functionality in the Class Name field.

    Plug Ins Record
  10. Click OK.
  11. Save and Close the Entities record.
  12. Close and reopen the Aptify client.
  13. Use the records in the entity to preform a test to confirm that the system successfully uses the functionality defined by the plug-in you added.

Sample Duplicate Check Objects

Aptify provides the compiled object and source code for two sample duplicate check objects: one for Persons and one for Companies. A developer can use these samples as a basis for writing his or her own duplicate check object for an entity. Note that these objects are provided as samples only since what may be considered a duplicate will vary from entity-to-entity and from organization-to-organization. Additional sample duplicate check objects are included with the sample application. See About the Sample Application Duplicate Check Objects for details.

The sample objects use the following logic to identify duplicates:

  • Sample Persons Duplicate Check Object (AptifyPersonDupeCheck.dll): When a user attempts to save a new Persons record, this sample object checks for existing Persons records that have the same First and Last Name. If any matches exist, Aptify identifies these records as potential duplicates.
  • Sample Companies Duplicate Check Object (AptifyCompanyDupeCheck.dll): When a user attempts to save a new Companies record, this sample object checks for existing Companies records that have the same exact Name. If any matches exist, Aptify identifies these records as potential duplicates.

By default, the Aptify installer adds these sample objects to the Aptify Object Repository, but the duplicate checking functionality is not enabled.

See Enabling the Persons and Companies Sample Duplicate Object to turn on the sample duplicate check object for the Persons and/or Companies entity:

Related topics


 

Copyright © 2014-2019 Aptify - Confidential and Proprietary