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.
      
   2. Form Template Layout Control: find the Key Value of the existing JavaScript Layout Control UI Part.
      
   3. Form Component: find the Key Value of the existing JavaScript Layout Control UI Part
      This can sometimes be tricky with stock Form Components. Older "magic" Components do not always have a UI Platform specified in metadata.
      
      1. First check the metadata on the Form Component record:
         
      2. If you can find the Key Value this way, you're done!
      3. If the Form Component has no UI Platform specified, you'll have to figure out what the Key Value is based on the HTML5 metadata generated for a Form Template Part that uses that Form Control.
         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 Key Value of the Form Component.
               
   4. Dashboard Component: find the Key Value of the existing JavaScript Layout Control UI Part.
      This can sometimes be tricky with stock Dashboard Components. Older "magic" Components do not always have a UI Platform specified in metadata.
      1. First check the metadata on the Dashboard Component record:
         
      2. If you can find the Key Value this way, you're done!
      3. If the Form Component has no UI Platform specified, you'll have to figure out what the Key Value is based on the HTML5 metadata generated for a Dashboard Part that uses that Dashboard Control.
         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 Key Value of the Dashboard Component.
               

Related articles