View mApp Changes

Use the mApp Changes window in the mApp Editor to view the system definitions that will be changed by the active mApp when it is applied to the target system. When you view mApp changes, you can:

  • Select how changes are grouped (by Business Object, Definition Type, or View).
  • Search for specific items in the mApp.
  • Remove items from the mApp.
  • Compare the mApp definitions with the original system definitions.

The indicators next to each definition show the selected merge actions.

Icon Merge Action Description
Overwrite Icon Overwrite Existing definition will be overwritten (or added if it does not exist).
Import Icon Import if not found Definition will be imported if it does not already exist in the target system.
Remove Icon Remove Existing definition will be removed from target system.
Merge Icon Merge Definition will be merged into target system (only selected areas will be overwritten).
For Reference Only Icon For Reference Only Definition is included in mApp for informational purposes only.
No Icon Don't Import Definition will not be imported into target system.

The mApp Changes window can be opened from the mApp Editor Menu Bar (File>mApp Changes).

mApp Changes

  1. Display: Groups items in the tree by Business Object, Definition, or View.
    • By Business Object: Groups changes by Business Object (ex: Incident).
    • By Definition Type: Groups changes by the type of system definition (ex: Forms).
    • By View and then Business Object: Groups changes by View (ex: Default, Portal Default) and then by Business Object (ex: Incident).
    • By View and then Definition Type: Groups changes by View (ex: Default, Portal Default) and then by type of system definition (ex: Forms).
  2. mApp Type: Filters items in the tree by merge action:
    • Do Not Overwrite: Displays items marked Do Not Overwrite (definition will remain unchanged in the target system).
    • For Reference Only: Displays items marked For Reference Only (definition is included in the mApp for informational purposes only).
    • Import if not found: Displays items marked Import (definition will be imported into the target system if it does not already exist).
    • Merge by area: Displays items marked Merge (individual areas of the definition have separate merge actions).
    • Overwrite: Displays items marked Overwrite (definition will be overwritten in the target system).
    • Remove if found: Displays items marked Remove (definition will be removed from the target system if it already exists).
  3. Search: Searches for items by keyword or phrase.
    1. In the Search Box, provide a word or phrase to search for. The drop-down displays the most recently used (MRU) searches.
    2. Click Go to run the search. The items containing the specified word or phrase are displayed within their hierarchical structure.
  4. mApp Changes Tree: Displays items in a hierarchical tree grouped by the selected Display option.
    • Click the arrow next to a category (Business Object, Definition Type, or View) to expand it and view its items. Click the arrow again to collapse it.

      Tip: Right-click a category or item to open a context menu, and then select options to expand/collapse the tree, remove items, or compare definitions.

  5. Remove/Compare:
    • Click Remove to remove a selected item from the mApp (it is not removed from the system).
    • Click Compare to open the mApp Differences window and compare the mApp definition with the existing system definition. This a low-level comparison of the individual properties that make up the definition.
      Note: Remove and Compare are only enabled when an individual definition is selected. You cannot remove or compare definitions by selecting display categories (Business Object, Definition Type, or View).

      mApp Differences

    • Select the Different Items Only check box to limit the list of existing system definitions to those that the mApp affects.
© Copyright 2018 Cherwell Software, LLC. All rights reserved.