Add a Business Object to a Protected mApp™ Solution

The Add Business Object to mApp Solution wizard (accessed from within the mApp Editor) is a specialized tool that adds Business Objects and their associated Fields, Relationships, Forms, Grids, and Form Arrangements to a mApp Solution.

Use the Add Business Object to mApp Solution Wizard to select which Business Object to add to the Protected mApp Solution and define its importance to the Protected mApp Solution.

For a full explanation of the Wizard, see: Add a Business Object to a mApp Solution in conjunction with this help topic.

For help on how a Protected mApp Solution differs from any other mApp Solution , see: Protected mApp™ Solutions.

To add a Business Object to a Protected mApp Solution:

Open the mApp Editor.
Select a Business Object in the Object tree, and then select the Add Business Object to mApp Wizard task in the Structure area.
Select a Business Object to include in the Protected mApp Solution, and then specify its importance to the mApp Solution:
1. In the drop-down list, select a Business Object.
2. Define the importance of the Business Object to the Protected mApp Solution. See: Add a Business Object to a mApp Solution.
Select the Business Object Fields to merge in the target system:
- (Default) Merge all fields: Select this radio button to merge fields from the Protected mApp Solution with all existing fields in the target system.
  If field A (from the Protected mApp Solution) is merged with field B (in the target system), this results in fields A and B in your system after the merge.
  If field A (from the Protected mApp Solution) is merged with an identical field A (in the target system) from a previous mApp Solution, this results in an upgraded field A with the protected properties from the mApp Solution and the customized properties from the target system.
  If field A (from the Protected mApp Solution) and field B (in the target system) have the same field name, the field in your target system will be renamed with an underscore (_) prefix.
  Tip: Automatic renaming of duplicate names with an underscore (_) also applies to Item Managers, forms, relationships and other Business Object Definitions.
- Do not merge any fields: Select this radio button to make no changes to any of the existing fields in the target system.
- Let me choose: Select this radio button to select specific fields to overwrite.
Select which Relationships to merge in the target system:
- (Default) Merge all relationships: Select this radio button to merge relationships from the Protected mApp Solution with all existing relationships in the target system. See point 4 for a description of merging behavior.
- Do not merge any relationships: Select this radio button to make no changes to any of the existing relationships in the target system.
- Let me choose: Select this radio button to select specific relationships to overwrite.
Select which Business Object Forms to overwrite in the target system. See: Add a Business Object to a mApp Solution
Select which grids to overwrite or merge in the target system:
- (Default) Overwrite default grid only: Select this radio button to overwrite the default grid for the Business Object in the target system.
- Merge all grids: Select this radio button to merge the columns from all grids (default and other) into the target system.
- Do not merge any grids: Select this radio button to make no changes to any of the grids in the target system.
- Let me choose: Select this radio button to select specific grids to overwrite.
Select whether to overwrite the form arrangement (Major Business Objects only). See: Add a Business Object to a mApp Solution
Select which Form Arrangement Tabs to merge:
Note: Note: This page is displayed only if you are adding a Major Business Object to the mApp Solution, and if you selected to overwrite the form arrangement on the previous page.
- Merge all form arrangement tabs: Select this radio button to merge all Form Arrangement Tabs from the Protected mApp Solution with all existing all Form Arrangement Tabs in the target system.
- Do not merge any form arrangement tabs: Select this radio button to make no changes to the tabs in the target system.
- Let me choose: Select this radio button to select specific tabs to overwrite.
  Note: If a tab is included in a Protected mApp Solution, but the associated relationship is not added by the Protected mApp Solution and does not already exist in the target system, the tab will not be displayed in the target system.
Define whether to overwrite approvals. See: Add a Business Object to a mApp Solution
Define whether to merge Business Object Action areas:
Note: This page is displayed only for Major Business Objects that have Actions defined.
- Merge all actions: Select this radio button to merge all Business Object Action areas from the Protected mApp Solution with all existing all Business Object Action areas in the target system.
- Do not merge any actions: Select this radio button to make no changes to the Business Object Action areas in the target system.
- Let me choose: Select this radio button to select specific Business Object Action areas to overwrite.
  Note: Note: Actions are categorized by areas (menu, task pane, toolbar, context menu, and Automatic Actions). When you select one of the above options from the wizard, you are defining what to do with an entire area. However, you can define separate options for individual Actions within an area if you use the Business Object Actions window to configure merge actions for Business Object Actions.
Review the summary page.
Select Finish.

The Business Object and its associated fields, relationships, forms, grids, and form arrangements are added to the Protected mApp Solution. When the Protected mApp Solution is applied, these definitions are imported into a target system according to the selections you made.
Prepare the Protected mApp Solution for distribution (File > Prepare mApp Solution for distribution), or save the Protected mApp Solution(File > Save mApp Solution to Disk) to continue making other changes.