Define mApp Solution Properties

Use the mApp Solution properties window, accessed from within the mApp Editor, to define mApp Solution properties.

  • General properties:
    • Name and description: Specific name and description for the mApp Solution.
    • (Optional) Image: Image to represent the mApp Solution.
    • Created by: Name of mApp Solution creator (individual or organization).
    • (Optional) Details URL: Site that contains detailed information about the mApp Solution.
    • (Optional) Prevent mApp customizations during install: Removes the option to ignore parts of a mApp during an upgrade.
  • (Optional) Features: Definitions grouped together into subsections of functionality.

Good to know:

  • When system administrators apply a mApp Solution to a CSM system, the general properties are displayed in the Apply mApp Wizard. When Users view the mApp Solutions that have been installed in their systems, the general properties are shown in the Installed mApp Solutions window.
  • You must define at least the general properties in order for the mApp Solution to be considered ready for distribution.
  • If you have Globalization and multiple cultures enabled for your system and translations that impact your mApp Solution have been applied, you must define mApp Solution properties for each culture. For more information, see Applying Cultures to mApps.
  • Business Object and CSM Item definitions can be grouped together into Features (subsections of functionality) using mApp Solution conditions. Features can then be applied (or not) as a whole in the Apply mApp Wizard.

To define mApp Solution properties:

  1. Open the mApp Editor.
  2. From the mApp Editor menu bar, select File > mApp Properties.
  3. Select the General Properties page.
  4. Define general properties for the mApp Solution:
    • Name: Provide a display name to use for the mApp Solution.
    • Description: Provide a description of the mApp Solution. This should be as detailed as possible, as it is displayed in the Apply mApp Wizard.
    • Image: Select an image to associate with the mApp Solution.
      • None: Select this radio button to not associate an image with the mApp Solution.
      • File: Select this radio button to use an image for the mApp Solution. Then, select the Ellipses button Ellipses Button to browse to the location of the image file, select the file, and selectOpen.
    • Created by: Provide the name of the organization or individual who created the mApp Solution.
    • Details URL: If detailed information about the mApp Solution is available on a website, provide the URL here. Then, select the Ellipses button Ellipses Button to navigate to the site and ensure that the URL is correct.
    • Advanced Options : As a mApp author, select the Prevent mApp customizations during install checkbox to remove the Don't Change option when a mApp is applied during an upgrade. This means that the mApp is applied in its entirety during an upgrade, lessening the possibility of a mApp failure with customized content.
  5. Select the Features page.
  6. (Optional) Define mApp Solution Features:
    1. Select Add to add a new Feature.
    2. Define general properties for the Feature:
      • Name: Provide a name for the Feature.
      • Description: Provide a description of the Feature. This is the text that explains the Feature to the administrator applying the mApp Solution to his system, so ensure that the description is clear.
      • This Feature is enabled by default: Select this check box to include the mApp Solution Feature by default when the mApp Solution is applied to a CSM system using the Apply mApp Wizard.

    3. Select OK.

  7. Select the One-Step page.
  8. (Optional) Run a One-Step Action:
    • Select a recently used One-Step Action from the drop-down or select the Ellipses button to edit it or to select a different one.
    • Description: Provide a description of the One-Step Action. This should be as detailed as possible, as it is displayed in the Apply mApp Wizard and explains what the One-Step Action does. If it already has a description, it will be pre-populated.
    This option is not available using the CSM Configuration command-line.

    The Action must be an unassociated One-Step Action (not tied to a particular Business Object).

  9. Select OK.

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