Deploying the custom code-based applications to development environments
Before you begin
Make sure that you create a deployment package of the custom code-based application, so that you can deploy the custom application and data to development environments.
To create a deployment package
When you create a deployment package, the application definitions and data are exported from the BMC Helix Innovation Studio server to a deployment package.
To create a deployment package, perform the following tasks:
On the command prompt, navigate to the application's parent project directory.
For example:\projects> cd suggestion-boxRun the following command:
mvn install -PexportFor example:
\projects\suggestion-box> mvn install -Pexport
The deployment package that contains the project source code is created as a ZIP file at the target directory of the project. For example, \projects\suggestion-box\package\target\com.example.suggestion-box-1.0.0.SHAPSHOT.zip file.
The application definitions and data are exported to the ZIP file, which contains a db folder and all individual object definition files. For example, \projects\<application name>\package\target\db folder.
All individual object definition files are available in the following folders:
- association
- configuration
- named-list
- process
- record
- rule
- view
To set a preferred Home page for an application
When users log in, an application opens the first menu item on the navigation bar by default. However, this behavior can be customized to navigate users to a preferred Home page after login by following these steps:
- Log in to BMC Helix Innovation Studio and navigate to the Administration tab.
- Select Application management > Application settings.
- Select the required Application ID from the list or click New to create new application settings.
In the Edit application settings window, specify the following information:
Field name
Description
Example
Application ID
Enter your Application ID
Display Name
Enter a name for your application; this name will appear on the Navigation bar.
Home page path
You can copy the home page path directly from the browser's address bar after navigating to the desired view.
The home page path may include view input parameters and follow the format: view/<view definition name>?<view input parameters>.
Example: view/com.example.demoapplication::My%20Home%20Page?param1=foo¶m2=bar
Show in application launcher
Select the button to list your application in Application launcher
.
To deploy code-based applications
After you create deployment package for a custom code-based application or library, you can deploy the deployment package to BMC Helix Innovation Studio.
To deploy a package to the same environment, perform the following tasks:
On the command prompt, navigate to the application's parent project directory.
For example:\projects> cd suggestion-boxRun the following command:
mvn clean install -PdeployFor example:
\projects\suggestion-box> mvn clean install -Pdeploy
The deployment package that contains all definitions, data, and code required by an application or a library, is deployed to BMC Helix Innovation Studio. After an application is deployed, only the application developer and an administrator can view the application.
To undeploy code-based applications
On the command prompt, navigate to the application parent directory and run the following command:
For example: