Prepare a mApp for Distribution

Prepare a mApp for distribution when you are ready to submit the mApp to the mApp Exchange, or distribute it directly to potential users. When you prepare a mApp for distribution, it is scanned for errors and then saved as a .mApp file so that it can be applied to CSM systems.

Good to Know
  • If the mApp contains translations, you must define mApp properties for each culture before you can prepare the mApp for distribution. See Applying Translations to mApps.
  • If the mApp contains encrypted Fields, encryption will be disabled and the Fields will be converted to text in the distributable mApp file. If this occurs, you will be notified with a warning message.

To prepare a mApp for distribution:

  1. Scan the mApp before preparing it for distribution. This allows you to resolve any issues in the mApp, as well as in the underlying system from which the mApp was created.
  2. Open an existing mApp.
  3. From the mApp Editor menu bar, click File>Prepare mApp for distribution.
    Tip: You can also prepare a mApp for distribution by clicking Prepare mApp for distribution in the mApps section of the mApp Editor Task Pane.

    If there are errors that need to be resolved, the mApp Preparation Scan window opens.

    mApp Preparation Scan Results

  4. Resolve errors:
    • Click Resolve All to resolve all items in the list at once.
    • Click Resolve to resolve each selected item individually.

    After all errors are resolved (or if there are no errors), the Final Preparation for mApp Distribution window opens.

    Prepare mApp for Distribution

  5. Prepare the mApp for distribution:
    1. Define a location for the mApp Blueprint file (.mAppBP). This allows you to save the mAppBP file so you can return to it later and make changes, if necessary. The path where the file was last saved is displayed in the field.
      • Provide the path and filename where the file will be saved.
      • Click the Ellipses button Ellipses Button to browse to the location where the file will be saved.
    2. Define a location for the prepared mApp file (.mApp). This is the file that will be submitted to the mApp Exchange or distributed directly to potential users.
      • Provide the path and filename where the file will be saved.
      • Click the Ellipses button Ellipses Button to browse to the location where the file will be saved.
      • Create Compressed File: Select this check box to save the distributable mApp file in a compressed binary format. Compressed mApp files (designated with a .mappz extension) cannot be edited.
    3. View additional designers (only appears if the mApp includes definitions that were created or updated by other mApp creators). Each entry includes the mApp creator’s personal and/or company name as well as the most recent creation date/time.
  6. Click OK.

  7. Distribute the mApp.
© Copyright 2018 Cherwell Software, LLC. All rights reserved.