BAMOE Developer Tools - Visual Studio Marketplace

IBM BAMOE Developer Tools

IBM Business Automation Manager Open Editions (BAMOE) Developer Tools for VS Code lets you create, edit and visualize business processes (BPMN), decisions (DMN) and test scenarios (SceSim).

Features

🎨 Visual Editors

BPMN Editor (classic): Create and edit BPMN (*.bpmn) and BPMN2 (*.bpmn2) files.
BPMN Editor: Create and edit BPMN (*.bpmn) and BPMN2 (*.bpmn2) files and supports a new Gen AI Task for integrating with LLM models, Grid snapping, Dedicated panel for editing process variables etc.
DMN Editor (classic): Create and edit DMN 1.1 and DMN 1.2 (*.dmn) files.
DMN Editor: Create and edit DMN 1.2, 1.3, 1.4, 1.5, and 1.6 (*.dmn) files.
Test Scenario Editor (classic): Create and edit Test Scenario (*.scesim) files, compatible with DMN 1.1 and DMN 1.2.
Test Scenario Editor: Create and edit Test Scenario (*.scesim) files, compatible with DMN 1.2, 1.3, 1.4, 1.5, and 1.6.

🤖 AI-Powered Workflow Tasks

Gen AI Task ✨: Integrate Large Language Models (LLMs) directly into your BPMN workflows. Choose from multiple AI providers including IBM Watsonx, OpenAI, and Ollama to send prompts and receive AI-generated responses. Configure model parameters like temperature and token limits, test prompts in real-time, and seamlessly bind AI responses to process variables.
AI Agent Task 🤖: Delegate complex work to AI agents powered by Langflow. Connect to Langflow instances (local or remote), select from available AI agent flows, and provide user prompts with dynamic process variables. The workflow execution waits for the AI agent to autonomously complete the task and return results before proceeding to the next step.

🌍 Global Ready

Internationalization (i18n): Full support for 9 languages - Brazilian Portuguese (pt-BR), French (fr), German (de), Italian (it), Japanese (ja), Korean (ko), Simplified Chinese (zh-CN), Spanish (es), and Traditional Chinese (zh-TW) - making BAMOE accessible to customers worldwide with fully localized interfaces and content.

⚡ Productivity Features

Native keyboard shortcuts (Press shift+/ to display available combinations).
Export diagrams to SVG (use the SVG icon on the top-right corner).

Editing a new BPMN file

alt

Editing a new BPMN file (classic)

alt

Editing a new DMN file

alt

Editing a new DMN file (classic)

alt

Settings

Setting	Description	Default value
`kogito.bpmn.runOnSave`	Execute a command on each save operation of the BPMN file	empty
`kogito.bpmn.svgFilenameTemplate`	Filename template to be used when generating SVG files	`${fileBasenameNoExtension}.svg`
`kogito.bpmn.svgFilePath`	Where to save generated SVG files	`${fileDirname}` or `src/main/resources/META-INF/processSVG` if BPMN model is inside `src/main/resources`
`kogito.dmn.runOnSave`	Execute a command on each save operation of the DMN file	empty
`kogito.dmn.svgFilenameTemplate`	Filename template to be used when generating SVG files	`${fileBasenameNoExtension}.svg`
`kogito.dmn.svgFilePath`	Where to save generated SVG files	`${fileDirname}` or `src/main/resources/META-INF/decisionSVG` if DMN model is inside `src/main/resources`
`bamoe.accelerators.definitions`	A list of Accelerators available to apply to the current workspace	See Accelerators Settings

The kogito.*.svgFilenameTemplate and kogito.*.svgFilePath settings accept the following variables as tokens:

Variable	Example
${workspaceFolder}	`/home/your-username/your-project`
${fileDirname}	`/home/your-username/your-project/folder`
${fileExtname}	`.ext`
${fileBasename}	`file.ext`
${fileBasenameNoExtension}	`file`

Accelerators Settings

bamoe.accelerators.definitions contains a list of Accelerators that becomes available when the command BAMOE Developer Tools: Apply Accelerator, in the Command Palette, is triggered.

You can read more about Accelerators here.

With each release of the BAMOE Developer Tools for VS Code, the default value updates to reflect the current Accelerator versions and their availability.

The default value uses the following pattern, changing the gitRepositoryGitRef at each release:

"bamoe.accelerators.definitions":{
  "accelerators": [
    {
      "bpmnDestinationFolder": "src/main/resources/bpmn",
      "dmnDestinationFolder": "src/main/resources/dmn",
      "gitRepositoryGitRef": "9.4.1-ibm-0002-workflows-quarkus-maven",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Workflows (Quarkus + Maven)",
      "otherFilesDestinationFolder": "src/main/resources/others",
      "scesimDestinationFolder": "src/test/resources/scesim"
    },
    {
      "bpmnDestinationFolder": "src/main/resources/bpmn",
      "dmnDestinationFolder": "src/main/resources/dmn",
      "gitRepositoryGitRef": "9.4.1-ibm-0002-workflows-quarkus-gradle",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Workflows (Quarkus + Gradle)",
      "otherFilesDestinationFolder": "src/main/resources/others",
      "scesimDestinationFolder": "src/test/resources/scesim"
    },
    {
      "bpmnDestinationFolder": "src/main/resources/bpmn",
      "dmnDestinationFolder": "src/main/resources/dmn",
      "gitRepositoryGitRef": "9.4.1-ibm-0002-workflows-spring-boot-maven",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Workflows (Spring Boot + Maven)",
      "otherFilesDestinationFolder": "src/main/resources/others",
      "scesimDestinationFolder": "src/test/resources/scesim"
    },
    {
      "bpmnDestinationFolder": "src/main/resources/bpmn",
      "dmnDestinationFolder": "src/main/resources/dmn",
      "gitRepositoryGitRef": "9.4.1-ibm-0002-workflows-spring-boot-gradle",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Workflows (Spring Boot + Gradle)",
      "otherFilesDestinationFolder": "src/main/resources/others",
      "scesimDestinationFolder": "src/test/resources/scesim"
    },
    {
      "bpmnDestinationFolder": "src/main/resources/bpmn",
      "dmnDestinationFolder": "src/main/resources/dmn",
      "gitRepositoryGitRef": "9.4.1-ibm-0002-decisions-quarkus-maven",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Decisions (Quarkus + Maven)",
      "otherFilesDestinationFolder": "src/main/resources/others",
      "scesimDestinationFolder": "src/test/resources/scesim"
    },
    {
      "bpmnDestinationFolder": "src/main/resources/bpmn",
      "dmnDestinationFolder": "src/main/resources/dmn",
      "gitRepositoryGitRef": "9.4.1-ibm-0002-decisions-quarkus-gradle",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Decisions (Quarkus + Gradle)",
      "otherFilesDestinationFolder": "src/main/resources/others",
      "scesimDestinationFolder": "src/test/resources/scesim"
    },
    {
      "bpmnDestinationFolder": "src/main/resources/bpmn",
      "dmnDestinationFolder": "src/main/resources/dmn",
      "gitRepositoryGitRef": "9.4.1-ibm-0002-decisions-spring-boot-maven",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Decisions (Spring Boot + Maven)",
      "otherFilesDestinationFolder": "src/main/resources/others",
      "scesimDestinationFolder": "src/test/resources/scesim"
    },
    {
      "bpmnDestinationFolder": "src/main/resources/bpmn",
      "dmnDestinationFolder": "src/main/resources/dmn",
      "gitRepositoryGitRef": "9.4.1-ibm-0002-decisions-spring-boot-gradle",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Decisions (Spring Boot + Gradle)",
      "otherFilesDestinationFolder": "src/main/resources/others",
      "scesimDestinationFolder": "src/test/resources/scesim"
    }
  ]
}

Each configured Accelerator needs the following properties:

Setting	Description
`bpmnDestinationFolder`	The destination folder for .BPMN and .BPMN2 files.
`dmnDestinationFolder`	The destination folder for .DMN and .PMML files.
`gitRepositoryGitRef`	The Git ref (branch) used as source for the Accelerator.
`gitRepositoryUrl`	The Git repository URL used as source for the Accelerator.
`name`	The name of the Accelerator, visible in the `BAMOE Developer Tools: Apply Accelerator`
`othersFilesDestinationFolder`	The destination folder for others files.
`scesimDestinationFolder`	The destination folder for .SCESIM files. If not set, the `dmnDestinationFolder` is used instead.

Updating Accelerators Settings

These Accelerators settings are stored in the Default settings.json file. You can view it using command: Preferences: Open Default Settings (JSON).

You can use custom Accelerators configuration in User settings.json or Workspace settings.json. The configuration format has the same structure as described above. To edit User or Workspace settings.json you can use commands Preferences: Open User Settings (JSON) or Preferences: Open Workspace Settings (JSON) accordingly.

⚠️ Important: Only the Default settings.json is updated automatically with each BAMOE Developer Tools update. Custom or Workspace settings.json must be updated manually.

Accelerators

Accelerators are Git repositories that contain a skeleton of an application and will convert a working directory with your .dmn and .bpmn files into a fully functional application that can be built and deployed.

After creating yours you must define where resources should be placed inside these repositories. For example, .dmn files should be placed inside src/main/resources for a Quarkus application. As a bonus, adding an image/logo can be used to better represent your Accelerator wherever it's listed.

The Accelerator configuration

It looks like this:

{
    name: "Your Accelerator name",
    iconUrl: "https://link.to/your/logo/image",
    gitRepositoryUrl: "https://github.com/...",
    gitRepositoryGitRef: "branchName",
    dmnDestinationFolder: "path/to/place/dmn/files",
    bpmnDestinationFolder: "path/to/place/bpmn/files",
    otherFilesDestinationFolder: "path/to/place/other/files",
    scesimDestinationFolder: "path/to/place/scesim/files",
}

name: This is how the Accelerator will be known inside KIE Sandbox.
iconUrl: An optional parameter to add an image/logo besides you Accelerator name.
gitRepositoryUrl: This is where your Accelerator is hosted. Should be an URL that can be used with git clone.
gitRepositoryGitRef: Where in your repository is this Accelerator located. Could be a branch, commit, tag, anything that can be used with git checkout.
dmnDestinationFolder: Where your DMN and PMML files will be moved to after applying the Accelerator.
bpmnDestinationFolder: Where your BPMN files will be moved to after applying the Accelerator.
otherFilesDestinationFolder: Where other files will be moved to after applying the Accelerator.
scesimDestinationFolder: Where your Test Scenario (*.scesim) files will be moved to after applying the Accelerator. If not set, the dmnDestinationFolder is used instead.

Here's an example of what it should look like:

{
    name: "Quarkus",
    iconUrl: `https://github.com/apache/incubator-kie-sandbox-quarkus-accelerator/raw/0.0.0/quarkus-logo.png`,
    gitRepositoryUrl: "https://github.com/apache/incubator-kie-sandbox-quarkus-accelerator",
    gitRepositoryGitRef: "main",
    dmnDestinationFolder: "src/main/resources/dmn",
    bpmnDestinationFolder: "src/main/resources/bpmn",
    otherFilesDestinationFolder: "src/main/resources/others",
    scesimDestinationFolder: "src/test/resources/scesim",
}