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

Create and edit BPMN (*.bpmn) and BPMN2 (*.bpmn2) files using both BPMN Editor (classic) and the new BPMN Editor.
Create and edit DMN 1.1 and DMN 1.2 (*.dmn) files using DMN Editor (classic).
Create and edit DMN 1.2, 1.3, 1.4, and 1.5 (*.dmn) files using the DMN Editor.
Create and edit Test Scenario (*.scesim) files using the Test Scenario Editor (classic), compatible with DMN 1.1, and DMN 1.2.
Create and edit Test Scenario (*.scesim) for DMN 1.5 using the Test Scenario Editor, compatible with DMN 1.2, 1.3, 1.4, and 1.5.
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 (classic)

alt

Editing a new BPMN file

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.2.1-ibm-0005-quarkus-full",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Quarkus (Full)",
      "otherFilesDestinationFolder": "src/main/resources/others",
      "scesimDestinationFolder": "src/test/resources/scesim"
    },
    {
      "bpmnDestinationFolder": "src/main/resources/bpmn",
      "dmnDestinationFolder": "src/main/resources/dmn",
      "gitRepositoryGitRef": "9.2.1-ibm-0005-quarkus-dmn",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Quarkus (DMN)",
      "otherFilesDestinationFolder": "src/main/resources/others",
      "scesimDestinationFolder": "src/test/resources/scesim"
    },
    {
      "bpmnDestinationFolder": "src/main/resources/bpmn",
      "dmnDestinationFolder": "src/main/resources/dmn",
      "gitRepositoryGitRef": "9.2.1-ibm-0005-spring-boot-dmn",
      "gitRepositoryUrl": "https://github.com/IBM/bamoe-canvas-quarkus-accelerator",
      "name": "Spring Boot (DMN)",
      "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.