Configuring and Deploying Extension Bundles

Extension bundles are deployable zip packages consisting of different objects such as tables, IDOs, AES events, DataViews, and forms. These bundles are created for the purpose of moving customer or partner extended Mongoose application functionality from one tenant or configuration to another.
Use this form in Conjunction with the Extension Bundles form and the Deployment form, to configure, generate, download, and deploy an extension bundle to a target tenant or configuration.
Note: Only users with MGCoreTrans and MGDeveloper license modules can access the Extension Bundles form.

Prior to being able to configure an extension bundle, one must be created on the Extension Bundles form. While creating the extension bundle, specify a name. Optionally, provide a description, a namespace if a global bundle to be available across other tenants is needed, a revision for reference, and save.

Configuring an Extension Bundle

  1. On the Configure Extension Bundles form, specify an Object Type that is needed to add to an extension bundle, from the available types.
    See Object Types for the available object types in the Configure Extension Bundle form.
  2. Optionally, specify an Object Name Filter. The filter will be used as a part of selecting the Search button.
    Note: Wildcards may also be used in the filter. For example, if looking for objects that contains the word "item" in the form name, specify Form and Form Dependencies in the Object Type combo box and *item* in the Object Name Filter.
  3. Specify the Scope Type in the Scope combo box.
    Note: If the Scope combo box is grayed out, then the Object Type currently being configured does not relate to a specific Scope. However, it likely will relate to an AccessAs attribute (IDOs, Events for example) and any objects being configured will be for the AccessAs value that is currently used in the session.
  4. Click the Search button to run the search and retrieve the objects to be added to the extension bundle.
    If multiple Object Type needed to be added to the Extension Bundle, the search mus be performed multiple times, once for each Object Type.
  5. Select All and Deselect All buttons are available for use to help with the selection or exclusion of objects.
    Correct the listing of objects to be added to the bundle by checking or unchecking the Inc grid column. Once the list of the necessary objects have been included, in the Extension Bundles section of the form at the bottom use the combo box to choose the Extension Bundle that is being configured and press the Add To Bundle button.
  6. If an object is inadvertently added to an Extension Bundle, right-click on the left edge of the grid below the Extension Bundle combo box and select Delete as necessary.
    Completing the steps as necessary will configure the Extension Bundle.

Deploying the Extension Bundle

  1. Access the Extension Bundles form, filter or select a specific bundle.
  2. Use the Generate button to generate the bundle.
  3. Click Download to download the .zip file with the necessary objects metadata for deployment.
    Note: At this point ensure that you have a successful backup of the target deployment database metadata before applying any extension bundle functionality.
  4. Log into the target tenant where the Extension Bundle needs to be deployed and access the Deployment form.
  5. In the Deploy Applet area on the form select the Import button.
  6. Click the Select File button to browse and select the bundle zip file.
  7. Click the Upload button to pull in the zip file and click the Execute Scripts button to apply the bundle metadata in the zip to the current tenant.
    Use the View Log button to verify the successful deployment or see any errors that may have occurred.
    Note: Make sure to discard the IDO cache and Forms cache before trying to test any of the new deployed functionalities.