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.

Deploying your application for the first time to start working in BMC Helix Innovation Studio

Before you begin, make sure that you create a project for an application (or library) development.

To manage the data for the application (or library), you should deploy the deployment package to the BMC Helix Innovation Studio.

The following video (5:07) provides you with the information to deploy the Maven project to the BMC Helix Innovation Studio.

The video shows an older version of BMC Helix Innovation Studio. Although there might be minor changes in the UI, the overall functionality remains the same.

To deploy a package

Navigate to the <artifactId> directory (parent folder) of your application project (or library project) and run the following command: 

 mvn clean install -Pdeploy 

For example:

\projects> cd suggestion-box
\projects\suggestion-box> mvn clean install -Pdeploy 


After you complete the initial deployment, if you deploy the package multiple times using the command mvn clean install -Pdeploy, duplicate log configurations are created for the application, and the following error occurs:

DeploymentPackage [packageDeployStatus=Error, packageName=com.example.test-smart-app, packageVersion=1.0.00-SNAPSHOT,  currentServersInSync=true, newlyAddedServers=[], jarToServerDeployStatusMap={onbmc-s=ReadyDeploy}, ErrorMessages=PARSE_DEF_IMPORT_STATUS:
IMPORT_APPLICATION_ERROR: ERROR (382): The value(s) for this entry violate a unique index that has been defined for this form;  Error importing record 1: FormName: AppLocalConfig_ComponentBase
WARNING (55): The following item was not imported

As a workaround, after you complete the initial deployment,  run the following command to export the application: mvn install -Pexport.

When you deploy the package to the BMC Helix Innovation Studio:

  • The deployment package is created as a zip file; for example,
    It is located in the target directory in the application package directory; for example, \projects\suggestion-box\package\target\
  • The zip file consists of the following folders and files:
    • db
      • record
        • <record-definition-name1>.def
        • <record-definition-name2>.def
        • <record-definition-name3>.def
        • <record-definition-name3>.options
        • <record-definition-name3>.data
        • <record-definition-name3>.delete
      • process
        • <process-definition-name1>.def
        • <process-definition-name2>.def
      • rule
        • <rule-definition-name>.def
      • association
      • view
        • <view-definition-name>.def
      • named-list
        • <named-list-definition-name1>.def
        • <named-list-definition-name2>.def
      • localized-string
        • <localized-strings.def>
    • code <jar file>
    • package manifest file -  The name of this file is in the following format: <Bundle ID>.manifest
      For example: com.assocuation.ConfigData.manifest
    The .jar file stores the code for your application. The .def files store definitions for your application. 
  • You can access the application in BMC Helix Innovation Studio.


    You must use the credentials of the developer account to log in to the BMC Helix Innovation Studio. A developer account is set with an administrator role. The developer account does not require the domain identifier to log in. You can log in to BMC Helix Innovation Studio with just the user name without the domain.

In the BMC Helix Innovation Studio, on the Workspace tab, select deployed application. To launch the application, click Visit deployed application.

You can import the bundle project in Eclipse. Eclipse enables you to modify and test the Java code.
To import the application to Eclipse, you should import the POM file to Eclipse using the Import command (File > Import> General > Maven Projects) and set the root folder to the bundle directory of the project.


You cannot rename the bundle after importing it to Eclipse.

Where to go from here

Using components from another application or library

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