Overview
Business Central is the previous-generation web-based platform for authoring business automation assets such as data objects, rules, processes, cases and planning entities. It includes capabilities for monitoring, administration, and management of business automation assets. With the release of both IBM BAMOE Developer Tools and IBM BAMOE Canvas, most of the asset management capabilities were replaced or a different approach was taken. This section describes the migration of business assets created in Business Central so that developers can maintain them by using BAMOE Developer Tools, BAMOE Canvas or both.
Prerequisites
The following tools are required to migrate from Business Central to BAMOE Developer Tools. It is assumed that you have a current version of Business Central running to export certain types of assets to their supported form in BAMOE:
-
JDK 11 or later is installed.
-
Apache Maven 3.8.6 or later is installed.
-
Visual Studio Code IDE latest version
-
IBM BAMOE Developer Tools latest version of VS Code IDE extensions
Business Automation assets in Business Central
The following table focuses on business automation assets no longer supported in the new tools but available in Business Central. The table indicates how to manage assets in the absence of Business Central.
Asset Name | Asset Type | Description | Version 9.1.x Supported Tools | Additional Info. |
---|---|---|---|---|
Business Process |
Process (.bpmn) |
Modeled as Business Process & Notation (BPMN) diagrams |
BAMOE Developer Tools |
Used for straight-through-processing (STP) as well as rule-flow |
Decision Model |
Decision (.dmn) |
Modeled as Decision Modeling & Notation (DMN) diagrams |
BAMOE Developer Tools |
|
Technical Rule |
Decision (.drl) |
Drools Rule Language, used for technical rules |
BAMOE Developer Tools |
|
Decision Table (Spreadsheet) |
Decision (.xls) |
DRL-based decision table, modeled as an Excel spreadsheet |
BAMOE Developer Tools |
|
Test Scenario |
Decision (.scesim) |
Test scenario used for decision unit testing. Currently only DMN testing is available. DRL testing will be available in future. |
BAMOE Developer Tools |
|
Data Object |
Model (.java) |
Java data object used by rules and processes |
BAMOE Developer Tools |
Define as separate Maven dependency project |
Global Variable(s) |
Decision (.drl) |
Vocabulary definition |
BAMOE Developer Tools |
Managed directly in .drl files |
Domain Specific Language Definition |
Decision (.dsl) |
Vocabulary definition |
Deprecated |
|
Enumeration |
Model |
Vocabulary definition |
BAMOE Developer Tools |
Managed directly in .drl files |
Form |
Forms (.frm) |
Human Form |
Deprecated |
New form builder in future release |
Guided Decision Table |
Decision (.gdst) |
Guided Decision Table |
Deprecated |
Export from BC to Decision Table Spreadsheet (XLS) |
Guided Decision Table Graph |
Decision (.gdst-set) |
Guided Decision Table Graph |
Deprecated |
|
Guided Rule |
Decision (.rdrl) |
Guided Technical Rule |
BAMOE Developer Tools |
Copy source from BC to new Technical Rule (.drl) file |
Guided Rule Template |
Decision (.template) |
Template for guided rules |
BAMOE Developer Tools |
Copy source from BC to new Technical Rule (.drl) file |
Test Scenario (Legacy) |
Decision (.scenario) |
Legacy (guided) test scenario used for rule unit testing |
Deprecated |
Migration of deprecated assets
Although all the guided editors are deprecated in IBM BAMOE version 9.1.x, it is possible to convert certain guided assets to their non-guided and supported forms. The following table indicates the mapping from guided to non-guided form:
Asset Name & Type |
Description |
v9 Non-Guided Form |
Guided Decision Table (.gdst) |
Guided Decision Table |
Export from BC to Decision Table Spreadsheet (.xls) |
Guided Rule (.rdrl) |
Technical Rule (.drl) |
Copy source from BC to new Technical Rule (.drl) file |
How to Copy the asset source from Business Central
It is important to be aware that all guided assets are Drools Rule Language (.drl) files under the covers.
In most situations, a guided asset can be refactored into a non-guided asset by copying the source from the source tab in Business Central into a file with the file extension .drl
.
With that in mind, here is an example of how to accomplish this, using a Guided Rule
as an example:
Examples
As you can see, this is the default tab (Model)
in Business Central’s guided rule editor.
If you navigate to the Source
tab, you can see that the guided rule is an editor view on top of a standard technical rule
written using Drools Rule Language (DLR)
, as in the following example:
To turn this rule into a non-guided form so that it can be modified by BAMOE Developer Tools, follow these steps:
-
Copy the contents of the rule in the
Source
tab. -
Create a new text file, using proper naming conventions, and paste the contents from the
Source
tab into the new file. -
Give this file an extension of
.drl
. -
Add this file to the
src/main/resources
folder of your Maven project.
Note
|
Some guided rules, when authored with the guided rule editor, create additional rule attributes which may or may not continue to be relevant to your rule execution pattern.
Examples of these types of attributes are |
At this point you are free to modify the new technical rule
to your liking, such as updating to use rule units
, using OOPATH syntax
vs mvel
, etc.
How to Export the asset from Business Central
Guided Decision Tables are a wizard-led alternative to uploaded decision table spreadsheets for defining business rules in a tabular format. With guided decision tables, you are led by a UI-based wizard in Business Central that helps you define rule attributes, metadata, conditions, and actions based on specified data objects in your project. After you create the guided decision tables, the rules you defined are compiled into Drools Rule Language (DRL) rules as with all other rule assets.
Since the Guided Decision Table
editor in Business Central is deprecated, users will need to export guided decision tables to Excel format.
Here is an example of how to do this using a Guided Decision Table
as an example:
Examples
In order to turn this decision table into a non-guided form so that it can be modified by BAMOE Developer Tools, follow these steps:
-
Convert to XLS using the Business Central option on the button bar.
-
Select the newly created
.xls
file in the Project Explorer. -
Select one of the
Download
options on the button bar. -
Add this file to the
src/main/resources
folder of your Maven project.
As you can see in the diagram, this is the default tab (Model)
in Business Central’s guided decision table editor.
If you navigate over to the Source
tab, you will quickly see that the guided decision table is simply an editor view on top of a standard technical rule
written using Drools Rule Language (DLR)
, as in the following example:
At this point, you can choose to either take the same approach as with guided rules or to export the table to Excel format simply by clicking a button (Convert to XLS), as in the following example:
After the table is converted to XLS format, the new file is added to the Business Central Project Explorer
view.
Select the converted file and choose one of the Download buttons in Business Central, which downloads the converted spreadsheet file to your local machine. You can add this file to the src/main/resources folder of your Maven project.
Note
|
Guided decision tables are, under the covers, a collection of technical rules generated using .DRL syntax.
The number of rows in a decision table will equal the number of individual technical rules generated, one for each row.
Rules make use of |