Inherit From Stock JavaScript

When you want to extend or change stock functionality implemented in JavaScript, you should inherit from the stock JS "class".

Writing a client-side plugin that inherits from stock functionality is very similar to writing a stand-alone client-side plugin, with a little extra metadata configuration to make sure Aptify Web still loads the base JavaScript used by your derived JavaScript.

1. Figure out the fully-qualified name of the stock functionality you want to inherit from:
   

   1. GE Plugin: find the Key Value of the existing JavaScript Entity UI Part.

       Click here for a detailed guide...

      

   2. Form Template Layout Control: find the Key Value of the existing JavaScript Layout Control UI Part.

       Click here for a detailed guide...

      

   3. Form Component
      This can sometimes be tricky with stock Form Components. Older "magic" Components do not always have a UI Platform specified in metadata, so we can't always rely on finding the Key Value.
      

      1. First check the metadata on the Form Component record:

          Click here for a detailed guide...

         

         If you can find the Key Value this way, you're done!

      2. If the Form Component has no UI Platform specified, you'll have to figure out what the fully-qualified name is based on the HTML5 metadata generated for a Form Template Part that uses that Form Control.

          Click here for a detailed guide...

         1. Find or create a top-level Form Template containing a Form Template Part using the Form Component you're interested in. Note the ID of the Form Template and the ID of the Form Template Part.
         2. If you created or altered the Form Template, run the "Generate HTML5 Web Form Template UI Parts" Process Flow with these Input Properties:
            1. FormTemplateSelection: ListOfFormTemplateIDs
            2. FormTemplatesToGenerate: <the ID of your top-level Form Template>
            3. GenerateFormTemplateStaticData: True
            4. GenerateWizardFormTemplates: True
         3. Open the UI Part for the top-level Form Template. It's a Container-Type Part, so go to the Part Links tab and open the linked HTML Part. The information you need will be on the Text tab.
            
         4. You'll need to find the <div> that corresponds to the Form Template Part that uses the Form Component. If there's not much in the Text tab (as in the example above), you can probably do this just by visually scanning for the ID of the Form Template Part. However, this can be quite tedious with large amounts of text, so you're probably better off copying and pasting the text into a text editor or an HTML beautifier so you can search it.
            1. Find the <div> where the data-formtemplatepartid attribute is the ID of the Form Template Part. The data-partLoadFunction attribute for that <div> contains the fully-qualified name of the Form Component.
               
   4. Dashboard Component
      This can sometimes be tricky with stock Dashboard Components. Older "magic" Components do not always have a UI Platform specified in metadata, so we can't always rely on finding the Key Value.

      1. First check the metadata on the Dashboard Component record:

          Click here for a detailed guide...

         

         If you can find the Key Value this way, you're done!

      2. If the Form Component has no UI Platform specified, you'll have to figure out what the fully-qualified name is based on the HTML5 metadata generated for a Dashboard Part that uses that Dashboard Control.

          Click here for a detailed guide...

         1. Find or create a Dashboard containing a Dashboard Part using the Dashboard Component you're interested in. Note the ID of the Dashboard and the ID of the Dashboard Part.
         2. If you created or altered the Dashboard, run the "Generate HTML5 Web Dashboard UI Parts" Process Flow with these Input Properties:
            1. DashboardSelection: ListOfDashboardIDs
            2. DashboardsToGenerate: <the ID of your Dashboard>
         3. Open the UI Part for the Dashboard record. It's a Container-Type Part, so go to the Part Links tab and open the linked HTML Part. The information you need will be on the Text tab.
            
         4. You'll need to find the <div> that corresponds to the Dashboard Part that uses the Dashboard Component. If there's not much in the Text tab (as in the example above), you can probably do this just by visually scanning for the ID of the Dashboard Part. However, this can be quite tedious with large amounts of text, so you're probably better off copying and pasting the text into a text editor or an HTML beautifier so you can search it.
            1. Find the <div> with the a-dashboard-part-inner-<Dashboard Part ID> class. The data-partLoadFunction attribute for that <div> contains the fully-qualified name of the Dashboard Component.
               
2. Start with the JavaScript template code for the type of stock functionality you're overriding.

3. Near the top of the file, there is a call to Aptify.framework.inheritance.inherit(), i.e.

   GE Subclass (Entity Plugin)

   // Inherit from the Aptify Generic Entity
   Aptify.framework.inheritance.inherit(this, new Aptify.framework.genericEntity.aptifyGenericEntity());

   Layout Control

   // Inherit from the generic Form Template Layout
   Aptify.framework.inheritance.inherit(this, new Aptify.framework.formTemplates.UI.layout());

   Custom Control (Form Component) and Custom Dashboard Control (Form Component)

   // Inherit from the generic bound control
   // Do this even if your control is NOT bound to a specific field.
   Aptify.framework.inheritance.inherit(this, new Aptify.framework.dataControls.UI.boundControlBase(domElement));

   Instead of inheriting from base stock functionality, you need to change that line to inherit from the fully-qualified name you found in Step 1, i.e., if using the fully-qualified names used in the Step 1 examples:

   GE Subclass (Entity Plugin)

   // Inherit from the stock Aptify Persons GE Subclass
   Aptify.framework.inheritance.inherit(this, new Aptify.applications.persons.personsGE());

   Layout Control

   // Inherit from the stock Aptify Persons Form Template Layout Control
   Aptify.framework.inheritance.inherit(this, new Aptify.applications.persons.UI.personFormTemplateLayout());

   Custom Control (Form Component)

   // Inherit from the stock Aptify Multi Line Text Box
   Aptify.framework.inheritance.inherit(this, new Aptify.framework.dataControls.UI.multiLineTextBox(domElement));

   Custom Dashboard Control (Dashboard Component)

   // Inherit from the stock Entity List View
   Aptify.framework.inheritance.inherit(this, new Aptify.framework.views.UI.entityListView(domElement));

Related articles