The transition from BAMOE version 8.0.x to version 9.2.x marks a significant shift in how business automation solutions are developed and maintained. While version 8.0.x relied on a centralized, monolithic architecture centered around Business Central, version 9.2.x introduces a modular, cloud-native approach that separates the responsibilities of business users and developers.

This section introduces the new development experience in BAMOE version 9.2.x, highlighting the tools and architectural changes that support a more flexible and scalable workflow.

Installation and architecture overview

BAMOE version 8.0.x

Business Central

To use as a comparison basis, the diagram above shows an overview of BAMOE version 8.0.x development environment. Business Central was deployed alongside a KIE Server for developing and production execution, where the KJAR was uploaded, both running on JBoss EAP or WildFly. Business Central also hosted an internal Git repository (.niogit) and a Maven repository, making it the single point of control for source code, builds, and deployments.

In BAMOE version 8.0.x, development was tightly coupled to Business Central, which served as the central UI for authoring, testing, and deploying business assets. Building the project resulted into a KJAR (KIE JAR, a specialized JAR for KIE projects).

BAMOE version 9.2.x - BAMOE Canvas

BAMOE Canvas

BAMOE Canvas is a web-based modeling environment designed for business users and analysts. Unlike Business Central, which bundled all functionality into a single interface, BAMOE Canvas offers a clean and focused space for authoring and reviewing business assets. It currently supports both BPMN and DMN modeling, providing a streamlined experience for non-technical users.

BAMOE Canvas includes in-browser Git and file system capabilities, removing the need for an internal storage layer and enabling seamless integration with standard Git workflows. To support communication with external Git providers such as GitHub, GitLab, and Bitbucket, BAMOE Canvas uses the BAMOE CORS Proxy. Users can also deploy development versions of their projects to Kubernetes or OpenShift environments using the BAMOE Canvas Dev Deployments feature.

In addition, BAMOE Canvas includes BAMOE Extended Services, which enable the DMN Runner—​a live feedback tool that allows users to execute DMN models directly within the browser.

For detailed setup instructions, refer to the BAMOE Canvas documentation.

BAMOE version 9.2.x - BAMOE Developer Tools for VS Code

BAMOE Canvas

The BAMOE Developer Tools for VS Code is a Visual Studio Code extension designed for developers who need to author, test, and maintain business automation assets. This extension includes graphical editors for BPMN models, DMN models, and Test Scenarios files. It also supports the generation of User Task forms, providing a comprehensive toolset for building Business Service projects.

Because it runs within VS Code, the extension stores files locally on the developer’s file system. This allows full integration with Git for version control and with Maven for building, testing, and packaging projects. Unlike Business Central, the BAMOE Developer Tools for VS Code do not include a built-in Maven or Git repository. Instead, all required libraries are retrieved from the BAMOE Maven Repository, which can be deployed as a standalone container or installed locally in the .m2 directory.

To get started with the BAMOE Developer Tools for VS Code, follow the setup instructions in the official documentation. For information on configuring the Maven repository, refer to the BAMOE Maven Repository documentation.

Creating projects

Unlike Business Central, BAMOE version 9.2.x does not use the concept of Spaces. Projects are now organized using Git repositories and follow standard Maven structures. A project can be implemented using Kogito with Quarkus, Spring Boot, or plain Java with Drools or jBPM.

BAMOE Canvas

In BAMOE Canvas, creating a new file, trying a sample, or cloning a repository from the welcome screen will initialize a new workspace. A workspace is a lightweight environment where users can begin modeling assets immediately. If the workspace is not already a Maven project, users can apply a BAMOE Accelerator to expand it into a full project structure.

BAMOE Accelerators are project templates that include the necessary folder structure, configuration files, and dependencies. Users can choose between the Full BAMOE Accelerator, which supports both workflows and decisions, or the DMN BAMOE Accelerator, which is focused on decision services.

BAMOE Developer Tools for VS Code

For developers using the BAMOE Developer Tools for VS Code, the recommended way to start a new project is to clone a BAMOE Accelerator from a Git repository. This provides a ready-to-use project structure with all required dependencies and configurations for building and testing Business Service projects.

Alternatively, developers can manually create the folder structure and configure the project using standard Maven conventions. While this approach offers more flexibility, it requires familiarity with the necessary dependencies and project layout.

In both cases, the project is managed as a standard Maven project, with all assets stored as plain text files. This makes it easy to integrate with Git for version control and to use Maven for building, testing, and packaging.

Authoring business automation assets

BAMOE Canvas

BAMOE Canvas offers a streamlined, browser-based environment for modeling and reviewing business assets. It supports both BPMN and DMN modeling through intuitive graphical editors. Users can start from scratch, import existing files, or explore sample projects directly from the BAMOE Canvas welcome screen.

The Problems tab offers real-time validation, and the DMN Runner enables users to test decision models directly in the browser using sample input data, making it easy to iterate and validate logic.

BAMOE Developer Tools for VS Code

The BAMOE Developer Tools for VS Code offer a full-featured environment for developers to author and manage BPMN, DMN, and SCESIM assets. The extension leverages the built-in VS Code Problems tab to provide real-time validation. It also supports generating user task forms and integrates with Maven for validation, testing, and packaging. This setup gives developers full control over the development lifecycle using familiar IDE workflows.

Working with Git repositories

In BAMOE version 8.0.x, Business Central managed source code through an internal Git server. Projects were stored in a hidden .niogit directory on the server’s file system, and access was limited to the Business Central interface.

In BAMOE version 9.2.x, Git integration is a core part of the development workflow, but the approach differs between BAMOE Canvas and the BAMOE Developer Tools for VS Code.

BAMOE Canvas

BAMOE Canvas includes built-in Git capabilities directly in the browser. Users can initialize a Git repository from a workspace, clone existing repositories from platforms like GitHub, GitLab, or Bitbucket, and perform common Git operations such as commit, push, and pull—​all without leaving the BAMOE Canvas interface.

To enable communication with external Git providers, BAMOE Canvas uses the BAMOE CORS Proxy, which must be configured in the BAMOE Canvas settings. Users also need to provide Git credentials or personal access tokens to authenticate with their chosen Git provider. Once configured, business users can collaborate on shared repositories without needing to understand Git internals or use a command-line interface.

This approach allows business users to contribute directly to the same codebase as developers, using a visual interface that abstracts away the complexity of Git.

BAMOE Developer Tools for VS Code

In contrast, the BAMOE Developer Tools for VS Code rely on the developer’s local Git installation. Git operations are performed using the built-in Git support in VS Code or through the command line, offering full control and flexibility for experienced users.

This setup is ideal for developers who are already familiar with Git workflows and want to integrate version control into their broader development process. It also allows for advanced Git features such as branching strategies, submodules, and integration with CI/CD pipelines.

While BAMOE Canvas simplifies Git for business users, the BAMOE Developer Tools for VS Code provide a more powerful and customizable Git experience for developers working in a traditional IDE environment.

Working with Maven and BAMOE Maven repository

In BAMOE version 8.0.x, Maven builds were triggered internally by Business Central. When a project was built through the UI, Business Central used an embedded Maven engine to compile the assets into a KJAR (KIE JAR), which was then deployed to a KIE Server. The internal Maven repository was also managed by Business Central, and users had limited visibility or control over the build process.

In BAMOE version 9.2.x, projects are built using standard Maven tools, and the build process is fully externalized. The BAMOE Maven Repository provides all required dependencies and can be deployed as a standalone container or installed locally.

BAMOE Canvas does not perform builds directly, but when a workspace is initialized with an Accelerator, it includes Maven configuration files that reference the BAMOE Maven Repository. Projects can then be exported and built externally.

For developers using the BAMOE Developer Tools for VS Code, the Maven repository is a core part of the development workflow. Projects are built and tested locally using Maven, and the repository ensures that all required libraries are available during the build process. This setup supports full automation and integration with CI/CD tools, making it suitable for enterprise-grade development.

For installation and configuration instructions, refer to the BAMOE Maven Repository documentation.

Managing users and authentication

In BAMOE version 8.0.x, user authentication was handled through a centralized login screen provided by Business Central. Authentication and user management were typically delegated to the application server, such as JBoss EAP or WildFly, using standard Java EE security mechanisms. This setup was tightly coupled to the deployment environment and often required administrative configuration on the server side.

In BAMOE version 9.2.x, authentication is decentralized and aligned with modern cloud-native practices. Each tool—​BAMOE Canvas and the BAMOE Developer Tools for VS Code—​handles authentication differently, based on its integration with Git.

BAMOE Canvas

In BAMOE Canvas, authentication is configured per Git. When connecting to a Git repository, users must authenticate using credentials or a personal access token associated with their Git provider (e.g., GitHub, GitLab, or Bitbucket). This is done through the Accounts modal in the Canvas settings, where users can manage their authentication sessions.

User management is handled externally by the Git, meaning that BAMOE Canvas does not maintain its own user directory. This simplifies administration and allows organizations to leverage existing identity and access management systems.

BAMOE Developer Tools for VS Code

The BAMOE Developer Tools for VS Code rely on the developer’s local Git configuration for authentication. When interacting with remote repositories, authentication is handled by the Git client, which may prompt for credentials, use SSH keys, or access stored tokens depending on the user’s setup.

This approach gives developers full control over how they authenticate and manage access to repositories, and it integrates seamlessly with enterprise Git workflows and credential managers.

By shifting authentication to Git, BAMOE version 9.2.x eliminates the need for centralized user management within the platform itself, offering a more flexible and secure model that aligns with modern development environments.

Building and deploying in development mode

In BAMOE version 8.0.x, builds were often triggered through the Business Central UI, which provided a tightly integrated authoring and deployment experience to a connected KIE Server. However, alternative approaches were also supported, such as building with Maven and deploying through CI/CD pipelines, depending on the project setup and environment.

BAMOE version 9.2.x adopts a more open and developer-friendly model. Projects are structured as standard Maven applications, allowing developers to build using the Maven CLI, integrate with IDEs, and automate deployments through CI/CD pipelines. Deployment targets include Kubernetes-native solutions.

BAMOE Canvas

While BAMOE Canvas itself does not perform builds, it supports development deployments through the Dev Deployments feature. This allows users to deploy their models to a Kubernetes or OpenShift cluster for testing purposes. The deployment process is configured through the BAMOE Canvas settings, where users can define the target cluster and credentials.

This feature is especially useful for business users who want to validate their models in a live environment without needing to understand the full build and deployment pipeline. It bridges the gap between modeling and runtime testing, enabling faster feedback loops.

BAMOE Developer Tools for VS Code

For developers, the BAMOE Developer Tools for VS Code provide full control over the build and deployment process. Projects can be built using standard Maven commands, and the resulting artifacts can be deployed to any supported runtime, including Kubernetes, or OpenShift.

Developers can also configure local or remote development environments, use containerization tools like Docker, and integrate with CI/CD systems. This flexibility allows teams to adopt modern cloud practices and tailor their deployment workflows to their specific needs.

Standard Operating Environment differences

The Standard Operating Environment (SOE) for BAMOE has evolved significantly between version 8.0.x and version 9.2.x. These changes reflect the shift toward a more cloud-native, containerized architecture in BAMOE version 9.2.x, which impacts supported platforms, middleware, and system requirements.

To understand the specific differences in supported environments, refer to the official IBM compatibility reports: