Create new JBoss Tools Documentation Jira issue
JBoss.orgCommunity Documentation
Version: 1.1.0.GA
Copyright © 2008, 2009, 2010 JBoss by Red Hat
This chapter gives you a short overview of JBoss BPMN Convert module.
JBoss BPMN Convert module is a tool used for a BPMN file translation.
As a part of JBoss tools, JBoss BPMN Convert module implements BPMN -> JPDL translation. You can get a basic JPDL file from a BPMN file by using this module.
The BPMN file may be written by hands or with the help of some editors. In this guide, we use STP BPMN editor to draw a BPMN file.
You can download the editor which is included into BPMN Modeler from Eclipse download or update site. On the Eclipse BPMN project page you can find the necessary links and other related information.
For a start, we propose you to look through the table of main features of JBoss BPMN Convert module:
Table 1.1. Key Functionality of JBoss BPMN Convert module
| Feature | Benefit | Chapter |
|---|---|---|
STP BPMN Editor | JBoss BPMN Convert module contains STP Business Process Modeling Notation (BPMN) Editor which is a tool to express any processes in a graphical form (simple diagrams with a set of some graphical elements). Created BPMN files can then be converted to jPDL. | creating a BPMN file by STP BPMN editor |
In this chapter we provide you with the necessary steps to translate a Bpmn file to a JPDL file.
Before creating a Bpmn file, you should have a Project created.
Create a project by New > Project... > General > Project. Enter the following information:
Project Name: test
Click on the Finish button.
Create a BPMN diagram file by New > Others... > Bpmn Diagram . Enter the following information:
File Name: test
Click on the Finish button.
Open the test.bpmn_diagram file by double-click it.
Draw the Bpmn diagram using STP BPMN editor. If you do not know how to use STP BPMN editor, please visit BPMN project page for details.
A Bpmn file may include more than one pool. Every pool can be mapped to a corresponding Jpdl file.
Select 'test.bpmn' file and right-click it. Open the export wizard by Export... > BPMN Export > BPMN -> JPDL .
Click on the Next button.
Select the BPMN file that you want to translate.
Click on the Next button.
Select the Pools of BPMN that you want to translate.
Click on the Next button.
On the next page, you may get error or warning messages that occurred during the conversion. If there are no messages, this page is skipped.
Click on the Next button.
Select the target location to save the generated JPDL files.
If you'd like to overwrite existing resources,check this "Overwrite existing resources" checkbox.
Click on the Finish button.
Then the JPDL files are generated to the target location.
The generated files look like this:
We hope, this guide helped you to get started with the JBoss BPMN Convert module. Besides, for additional information you are welcome on JBoss forum.