This documentation supports the 23.3 version of BMC Helix Innovation Suite (AR System and BMC Helix Innovation Studio).

To view an earlier version, select the version from the Product version menu.

Making applications that you develop licensable

When creating AR Systemapplications, integration system vendors (ISVs) authorized by BMC can make the applications licensable.

When licensing AR Systemapplications, you have two options:

  • Application licensable—Users must obtain an "application license" so that they can access the form data in the application. Without a valid application license installed on the server, users receive a licensing error when they try to perform any data-related operations on forms in the unlicensed application. In other words, they cannot get, modify, search, create, delete, or merge entries on any form.
  • Application and form licensable—In addition to the requirements for the application licensable option, users must obtain user-fixed or user-floating licenses based on individual forms. The application developer can select which forms in the application to make "user licensable," and users must have an application user license to access form data on these forms. These are the application user license types:
    • Fixed
    • Floating
    • Read
      Fixed and floating licenses have no restrictions and enable users to get, modify, search, create, delete, and merge entries. Read licenses enable users only to search, get, and create entries.

      Operation on entriesLicense requirements
      CreateDoes not need application or application user license.
      GetNeeds application license only.
      ModifyNeeds application and application user license.
      DeleteNeeds application and application user license.
      • If a merge operation results in a create, does not need application or application user license.
      • If a merge operation results in a modify, needs application and application user license.

By default, an application comes with zero fixed licenses, zero floating licenses, and an unlimited number of read licenses. If users are not assigned a fixed or floating license, they automatically use a read license by default. Guest users automatically use a read license.

This feature is intended to license your access to form data in the application; it is not intended to license administrative operations such as modifying forms or workflow in an application. Even if no application license is installed for a licensable application, administrators can still change or delete a form or workflow object.

The procedures in this topic are intended for use only by authorized ISVs who plan to license their applications for sale. If you are not an ISV and you create AR System applications that you want to license for sale, see the BMC Support website ( Open link ) for details.

To configure your applications to make them licensable

In this procedure, the MusicManager application contains three forms, but you want to make only one of them (MusicManager Songs) user licensable.


Licensing mode is a one-way operation. After an application is made licensable, the process cannot be reversed, even by the ISV. In addition, after an application is user licensed and the forms are checked, the forms cannot be unchecked and you cannot revert to licensing or non-licensing of the application. Export copies of these forms before you license the application so that you can recover the forms if you need to change licensing levels later on.

  1. Select Application > License Application

    Application Licensing dialog box
  2. From the Licensing Mode menu, select one of the following options:



    Do not license this application

    Application is not licensed. Typically, you use this default option if you do not intend to sell this application or if the application is for internal use only.

    License this application

    Entire application is licensed. An application license must be added to the Add or Remove Licenses form for users to access the form data in the application.

    Enable user licensing of this application and forms

    Specific forms in the applications can be made user-licensable. You decide which forms to make licensable. Users must obtain a user license to create, modify, merge, or delete form data. These licenses can be fixed, floating, or read.

    Users have read license permission if they are not assigned fixed or floating licenses.

    By choosing which forms in your application to make user-licensable, you can customize the user licensability of your application.

  3. In the Product Name field, enter the application license string, or in this scenario, XYZ:MusicManager.
  4. If you enable user licensing for the application and its forms, perform one of these actions:
    • Click inside the User Licensable list adjacent to the form you want to license, then select Yes or No. Repeat for other forms.
    • To license all forms in your application, click Select All.
    • To clear all forms from the User Licensable list, click Clear All.
      This step is optional for applications and is needed only to make forms in your application user licensable.
  5. Click OK.

Adding the application license to your server

Customers license ISV applications just like any other AR Systemapplication. The only difference is the unique naming convention of the application itself, indicating that the application comes from an ISV.  For information about adding application licenses to servers, see the Working with BMC Helix Innovation Suite licenses.

Was this page helpful? Yes No Submitting... Thank you