Chapter 12. Multiple branches in Business Central

download PDF

Multiple branches support in Business Central provides the ability to create a new branch based on an existing one, including all of its assets. All new, imported, and sample projects open in the default master branch. You can create as many branches as you need and can work on multiple branches interchangeably without impacting the original project on the master branch.

Red Hat Process Automation Manager 7.12 includes support for persisting branches, which means that Business Central remembers the last branch used and will open in that branch when you log back in.

12.1. Creating branches

You can create new branches in Business Central and name them whatever you like. Initially, you will only have the default master branch. When you create a new branch for a project, you are making a copy of the selected branch. You can make changes to the project on the new branch without impacting the original master branch version.


  1. In Business Central, go to Menu Design Projects.
  2. Click the project to create the new branch, for example the Mortgage_Process sample project.
  3. Click master Add Branch.

    Figure 12.1. Create the new branch menu

    Creating the new branch menu
  4. Type testBranch1 in the Name field and select master from the Add Branch window. Where testBranch1 is any name that you want to name the new branch.
  5. Select the branch that will be the base for the new branch from the Add Branch window. This can be any existing branch.
  6. Click Add.

    Figure 12.2. Add the new branch window

    Adding the new branch testBranch1

After adding the new branch, you will be redirected to it, and it will contain all of the assets that you had in your project in the master branch.

12.2. Selecting branches

You can switch between branches to make modifications to project assets and test the revised functionality.


  1. Click the current branch name and select the desired project branch from the drop-down list.

    Figure 12.3. Select a branch menu

    Selecting a branch menu

After selecting the branch, you are redirected to that branch containing the project and all of the assets that you had defined.

12.3. Deleting branches

You can delete any branch except for the master branch. Business Central does not allow you to delete the master branch to avoid corrupting your environment. You must be in any branch other than master for the following procedure to work.


  1. Click dots in the upper-right corner of the screen and select Delete Branch.

    Figure 12.4. Delete a branch

    Delete a branch
  2. In the Delete Branch window, enter the name of the branch you want to delete.
  3. Click Delete Branch. The branch is deleted and the project branch switches to the master branch.

12.4. Building and deploying projects

After your project is developed, you can build the project from the specified branch in Business Central and deploy it to the configured KIE Server.


  1. In Business Central, go to Menu Design Projects and click the project name.
  2. In the upper-right corner, click Deploy to build the project and deploy it to KIE Server.


    You can also select the Build & Install option to build the project and publish the KJAR file to the configured Maven repository without deploying to a KIE Server. In a development environment, you can click Deploy to deploy the built KJAR file to a KIE Server without stopping any running instances (if applicable), or click Redeploy to deploy the built KJAR file and replace all instances. The next time you deploy or redeploy the built KJAR, the previous deployment unit (KIE container) is automatically updated in the same target KIE Server. In a production environment, the Redeploy option is disabled and you can click Deploy only to deploy the built KJAR file to a new deployment unit (KIE container) on a KIE Server.

    To configure the KIE Server environment mode, set the org.kie.server.mode system property to org.kie.server.mode=development or org.kie.server.mode=production. To configure the deployment behavior for a corresponding project in Business Central, go to project Settings General Settings Version and toggle the Development Mode option. By default, KIE Server and all new projects in Business Central are in development mode. You cannot deploy a project with Development Mode turned on or with a manually added SNAPSHOT version suffix to a KIE Server that is in production mode.

    If the build fails, address any problems described in the Alerts panel at the bottom of the screen.

    To review project deployment details, click View deployment details in the deployment banner at the top of the screen or in the Deploy drop-down menu. This option directs you to the Menu Deploy Execution Servers page.

    For more information about project deployment options, see Packaging and deploying a Red Hat Process Automation Manager project.

Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.