Define Merge Actions for Field Advanced Properties

Use the Advanced page in the Field Properties window to define whether or not to overwrite the following merge areas:

  • Advanced Options: Whether the Business Object is read-only, cacheable, or has an associated color.
  • General Attributes.
  • Database Attributes.
    The Field Properties window is available in the Business Object Editor (accessed from within the Object Manager in the mApp Editor).

Good to know:

  • You can only configure separate merge actions for individual Business Object Fields and Field properties if the Business Object is set to Merge in the Business Object Properties window (mApp page). If the Business Object is set to any other option, or if Include in mApp is cleared, then you cannot configure separate merge actions for individual Field properties.
  • For more information about defining advanced Field properties, refer to Define Advanced Properties for a Field.

To configure merge actions for Field advanced properties:

  1. Add a Business Object to a mApp Solution using the Add Business Object to mApp wizard.
  2. Open the Field Properties window for a Field in the Business Object you just added to the mApp Solution:
    1. In the Object Manager within the mApp Editor, click the Edit Business Object task in the Structure area.

      The Business Object Editor opens, displaying the list of Fields with a mApp Action column to show the merge actions selected for the Fields in the Add Business Object to mApp wizard (either Overwrite or Do Not Overwrite. The mApp Action column is blank for Fields set to Do Not Overwrite). If you set the Business Object to Merge in the Business Object Properties window (mApp page), then the selections made in the Defaults section (Default Behavior for Fields drop-down menu) are also reflected in the mApp Action column.

      Tip: You can also click the Edit Business Object button Business Object Button on the mApp Editor toolbar to open the Business Object Editor.

    2. Click a Field, and then click the Field Properties button.
  3. Set the individual Field to Merge:
    1. Click the mApp Solutions page, and then check Include in mApp.
    2. In the Options area, click Import to Target System.
    3. From the If Already Present drop-down menu, select Merge as the merge action for the Field.
  4. Click the Advanced page.

    Field Advanced Merge Areas

  5. Click the mApp button mApp Solution Merge Actions next to each property merge area, and then select a merge action:

    For database settings:

    • Do Not Overwrite Database Settings: Select this option to leave the database settings unchanged in the target system when the mApp Solution is applied.
    • Overwrite Database Settings: Select this option to overwrite the database settings in the target system when the mApp Solution is applied.

    For general attributes:

    • Do Not Overwrite General Attributes: Select this option to leave the general attributes unchanged in the target system when the mApp Solution is applied.
    • Overwrite General Attributes: Select this option to overwrite the general attributes in the target system when the mApp Solution is applied.

    For database attributes:

    • Do Not Overwrite Database Attributes: Select this option to leave the database attributes unchanged in the target system when the mApp Solution is applied.
    • Overwrite Database Attributes: Select this option to overwrite the database attributes in the target system when the mApp Solution is applied.

    For presentation settings:

    • Do Not Overwrite Presentation Settings: Select this option to leave the presentation settings unchanged in the target system when the mApp Solution is applied.
    • Overwrite Presentation Settings: Select this option to overwrite the presentation settings in the target system when the mApp Solution is applied.

    For the value splitter:

    • Do Not Overwrite Value Splitter: Select this option to leave the value splitter unchanged in the target system when the mApp Solution is applied.
    • Overwrite Value Splitter: Select this option to overwrite the value splitter in the target system when the mApp Solution is applied.

  6. Select OK.

  7. 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.