This document discusses migrating projects from JBoss BRMS to the new JBoss BPM Suite 6. It outlines several changes required such as moving from Drools core to the new KIE framework, refactoring due to changes in the task service API, and ensuring tests are updated. It also provides instructions for migrating a sample customer evaluation demo project through cloning the source code repository and importing into the BPM Suite authoring tools.

1. Get a move on
with Red Hat JBoss BPM Suite 6
Eric D. Schabell
JBoss Technology Evangelist (Integration & BPM)

2. JBoss BPM Suite 6
Hallelujah
• Been waiting a long time...
– Developer vs Business?
– Migration?
2

3. Real-time data &
event feeds
Authoring tools
for business
users
Repository
Business
analysts
Event
processor
Business
rule
definitions
Rules
engine
Authoring tools
for developers
Developers
3
Business
data
Client
applications

4. Business Events
Authoring tools
for business
users
Enterprise
Applications
Repository
Event
processor
Business
rule
definitions
Business
analysts
Business
Process
Manager
Rules
engine
Web Services
Java
Authoring tools
for developers
Developers
Business
data
BAM
Business
users
4
Business
users

5. Migrate to JBoss BRMS / BPM Suite
• It's all git right?
– Check your project into git
– Clone into BRMS / BPM Suite
• Done?
5

6. But wait... JCR to Git tool?
Unsupported tool to migrate JCR repo to Git repo
Still testing, intented for migration of content...
6

7. Core changes
From Drools core to KIE (Knowledge Is Everything)
means refactor entire project
Backwards compatible with knowlegde-api.jar
knowledge-api-6.0.2-redhat-1.jar
jboss-bpms-6.0.0.GA-redhat-1-deployable-generic.zip
But you have tests right?
jbpm-test-6.0.2-redhat-1.jar != backwards compatible
7

8. Human task server
Process server bridged to Task Server with HornetQ
messaging.
TaskService API part of public BPM Suite public API
package changes == refactor imports
some api changes == refactor methods
Now local task service only, utility method provided
jbpm-human-task/jbpm-human-taskworkitems/src/main/java/org/jbpm/services/task/wih/util/Loc
alHTWorkItemHandlerUtil.java
8

9. Rest API
Access to the following areas:

Knowledge store


Jobs, Repositories, Organizational Units, Maven
Runtime
Process instances, with or without vars (start, variables, details,
abort, signal)


Work items (complete, abort)

History to view process instances completed

Complete task interface
https://access.redhat.com/site/documentation/enUS/Red_Hat_JBoss_BPM_Suite/6-Beta/htmlsingle/User_Guide/index.html#sect-Runtime_REST_API
9

10. Working with product backend
Avoid direct file access to repository BRMS / BPM
Suite
YES: git clone git://hostname/customer
NO: git clone file://path-to-install/.niogit/customer.git
10

11. Product maven repository
<repository>
<id>guvnor-m2-repo</id>
<name>Guvnor M2 Repo</name>
<url>http://localhost:8080/business central/maven2/</url>
</repository>
BPM assets in UI available as maven artifact; kjar.
11

12. Product maven dependency
<dependency>
<groupId>customer</groupId>
<artifactId>evaluation</artifactId>
<version>1.0</version>
</dependency>
Projects can add kjar as dependency (pom.xml)
12

13. Migration Demo
Simple Customer Evaluation Demo (STP)
a model, a rule, a process, and a unit test
https://github.com/eschabell/brms-customer-evaluation-demo
https://github.com/eschabell/bpms-customer-evaluation-demo
JBDS example fully functional, not running in UI
https://github.com/eschabell/bpms-customer-evaluation-demo/tree/v0.5
Initial attempt - Clone GIT repo to JBoss BPM Suite product
13

14. JBoss BPM Suite
Customer Evaluation Demo
• git clone
https://github.com/eschabell/bpms-customer-evaluation-demo.git
• see README.md
– read docs/*, no really, read docs/*
• products into installs/* (see installs/README) & run 'init.sh' file
• start demo './target/jboss-eap-6.1/bin/standalone.sh'
• login (u:erics p:bpmsuite)
– http://localhost:8080/business-central
• JBDS import customer-evaluation-demo
• Example kjar integration in unit test
14

15. Demo Code
15

16. 16

17. `

JBoss BRMS & BPM Suite Articles:



http://schabell.org/search/label/BRMS
http://schabell.org/search/label/BPMS
JBoss BPM Suite Demos:


http://www.schabell.org/2013/11/jboss-bpm-suite-automated-lending-generic-loan-demo.html

http://www.schabell.org/2013/12/bpms-examining-migrated-customer-evaluation-demo.html

https://github.com/eschabell/business-resource-optimizer-demo


http://www.schabell.org/2013/10/jboss-bpm-suite-rocking-the-mortgage-demo.html
https://github.com/eschabell/bpms-customer-evaluation-demo (migration from BRMS 5.3)
JBoss xPaaS Demos:


17
https://github.com/eschabell/bpms-bam-dashboard
https://github.com/eschabell/openshift-bpm-bam-dashboard

18. Build the Enlightened Enterprise
For more information, please visit
http://www.jboss.com
Demo code available at https://github.com/eschabell