Configure Merge Actions for Grids

The Add Business Object to mApp Wizard is the primary method of defining merge actions for a Business Object and its associated Grids. However, you can use the mApp Solution Options window in the Grid Editor to configure the following:

• General properties: Whether to include the Grid in the mApp Solution.
• Options for importing the Grid into the target system when the mApp Solution is applied:
  • Import to target system: Imports the Grid into the target system. You can select merge actions based on whether the Form already exists in the target system.
  • Remove from Target System: Removes the Grid from the target system.
  • For Reference Only: Includes the Grid in the mApp Solution for informational purposes only (it is not merged into the target system when the mApp Solution is applied).
  • Import/remove based on condition: Imports or removes the Grid based on configured conditions.

To configure merge actions for Grids:

1. Add a Business Object to a mApp Solution using the Add Business Object to mApp Wizard.
2. In the Object Manager within the mApp Editor, click the Business Object from the Object tree, and then click the Edit Grids task in the Appearance area.

   The Grid Editor opens.

   Tip: You can also click the Grid button in the mApp Editor toolbar to open the Grid Editor.

3. Configure merge actions for Grids:
   1. Select a Grid in the Grid drop-down (example: Default Grid), and then click the mApp Options button on the mApp Editor toolbar.

      

   2. Define general mApp Solution properties for the Grid:
      • Include in mApp: Select this check box to include the Grid in the mApp Solution. Clear this check box to leave the existing definition in the target system unchanged (the Grid is not imported into the target system when the mApp Solution is applied).

        Note: This check box is automatically selected if some or all of the Grids were set to overwrite when you added the Business Object to the mApp Solution (using the Add Business Object to mApp Wizard).

      • References: Click this button to open the References window and view all of the other definitions being used by the Grid.
   3. Define options (merge actions) for how the Grid will be merged into a target system:

      Note: These options are only available if Include in mApp is selected.

      • Import to target system: Select this radio button to import the Grid definition into a target system. Then, select a merge action based on whether or not the definition is already present in the target system:

        If already present: In the drop-down, select a merge action to define how the definition is imported if it already exists in a target system:

        • Overwrite: Select this option to have the mApp Solution definition overwrite the existing definition in the target system.
        • Don't Import: Select this option to leave the existing definition in the target system unchanged (the mApp Solution definition is not imported into the target system when the mApp Solution is applied).

        If not present: In the drop-down, select a merge action to define whether the definition is imported if it does not currently exist in the target system:

        • Import: Select this option to import the mApp Solution definition into the target system if does not already exist.
        • Don't Import: Select this option to skip importing the mApp Solution definition into the target system if it does not already exist (the mApp Solution definition will not be added to the target system).
      • Remove from Target System: Select this radio button to remove the Grid definition from a target system.
      • For Reference Only: Select this radio button to include the Grid definition in the mApp Solution for informational purposes only (the definition is not imported into the target system when the mApp Solution is applied).
      • Import/Remove Based on Condition: Select this check box to import or remove the Grid definition based on a condition. Then, click the Ellipses button to open the mApp Solution Conditions window and define mApp Solution conditions.

   4. Select OK.

      The mApp Solution Options button shows an indicator based on the selected merge action (example: for Overwrite).

4. Prepare the mApp Solution for Distribution (File>Prepare mApp for distribution), or save the mApp Solution (File>Save mApp to Disk) to continue making other changes.