This documentation supports the 19.11 version of BMC Helix Platform. 
To view an earlier version, select 19.08 from the Product version menu.

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

Before you begin make sure that you create a project for Digital Service application (or smart library) development. To manage the data for the application (or smart library), you should deploy the deployment package to the BMC Helix Platform server.

To deploy a package

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

 mvn clean install -Pdeploy 


The following video (5:07) provides details on how to deploy the Maven project to BMC Helix Platform server.

The video shows an older version of BMC Helix Platform. The previous product name was BMC Helix Innovation Suite. Although there might be minor changes in the UI, the overall functionality remains the same.

 https://youtu.be/A7B6xXoElw0

For example:

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

Important

As a developer, 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:
IMPORTING_SERVER:onbmc-s:10.133.77.92
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, export the application after you complete the initial deployment, by using the command mvn install -Pexport.

When you deploy the package to BMC Helix Platform server,

  • The deployment package is a zip file (for example, com.example.suggestion-box1.0SNAPSHOT.zip) is created. It is located in the target directory in the application package directory (for example, \projects\suggestion-box\package\target\com.example.suggestion-box1.0SNAPSHOT.zip).
    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>
      • configuration.data

      • role.data

    • code <jar file>
    • manifest file
    The .jar file is used to store the code for your application and the .def files are used to store definitions for your application. 
  • You can access the application in BMC Helix Innovation Studio.

    Note

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

  • In the BMC Helix Innovation Studio, from the application page, you can launch the application using the Launch Deployed Application link .

  • You can import the bundle project in Eclipse. Using Eclipse you can modify the Java code and test the 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.

    Note

    You cannot rename the bundle after importing it to Eclipse.

Where to go from here

Using components from another developer's Digital Service application or library

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

Comments