Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The BPMN to XPDL Conversion Plugin is used to convert BPMN xml to XPDL xml format to be uploaded to Joget Process Builder. 

Plugin Information

Plugins Available in the Bundle:

...

The user is able to import the converted XPDL xml file into Joget Process Builder.

Figure 1: BPMN in Visual Paradigm and XPDL in Joget (Basic decision model)


Image AddedImage Added

Figure 2: BPMN in BPMN.io and XPDL in Joget (Subflow Example, for more information: see this link)

Get Started

Current Supported Notations

BPMNXPDL in Joget
TaskActivity
Sub-ProcessSubflow
Start EventStart
End EventEnd
GatewayRoute
-Participant

Steps

Get BPMN xml file

Obtain any .bpmn or .xml file that is in BPMN 2.0 xml format.

Import BPMN to XPDL Conversion plugin into Joget App

1. You can obtain the jar file by the latest release at https://github.com/jogetoss/bpmn-xpdl-conversion/releases.

2. Upload the plugin jar file in Joget by going to Settings → Manage Plugins.

3. You can choose to import the demo app or create the app from scratch.

Steps for importing demo app

1. Download the demo app from https://github.com/jogetoss/bpmn-xpdl-conversion (.jwa file).

2. Go to Joget Home or All Apps and click on Import App to import the downloaded demo app.

Steps for creating app from scratch

1. Create a form with basic file upload fields, one for BPMN file upload and one for XPDL file output.

Figure

...

3: Form for BPMN and XPDL File Uploads


2. Attach the BPMN to XPDL Conversion plugin at Post Processing Tool. Run tool on both data creation and update.

Image Modified

Figure

...

4: Attaching BPMN to XPDL Conversion tool


3. Select the current form, and choose the file uploads fields that we created earlier for respective bpmn and xpdl fields. For more information, please refer to BPMN to XPDL Conversion Properties.

Image Modified

Figure

...

5: Plugin Configurations


4. Click on right upper corner Generate App > Generate CRUD.

Image Modified

Figure

...

6: Generate CRUD for form


5. Save and publish the app. Run the UI. Click new to add a new record. In the BPMN File Upload field, upload a BPMN xml file. After saving the form, the XPDL File will be converted at the XPDL File Output field.

Image Modified

Figure

...

7: Run UI and add new record


6. Click to edit the record saved earlier. Click on xpdlxml.xml to download the XPDL File.

Image Modified

Figure

...

8: Download converted XPDL file


7. Now go to Process Builder. Click + Add New process and click on XPDL view. Click on Upload XPDL button.

Image Modified

Figure

...

9: Add new process to import XPDL


8. Choose the XPDL file we downloaded in the form. Now go back to Design tab. We can see that the XPDL file has been successfully imported, same as the BPMN file. Now save the process. It will show that the builder is successfully saved. 

Image Modified

Figure

...

10: Successful imported XPDL to Joget Process

BPMN to XPDL Conversion Properties

Configure BPMN to XPDL Conversion

Figure 1011: Plugin Configurations for tool

Name

Description

BPMN File

Header

Form *

Form where field for BPMN file upload resides

Field *

Field of BPMN file upload

Record Id

Record ID of form record, if not filled, default value will be current process record ID.

XPDL File

Header

Form *

Form where field for XPDL file upload resides

Field *

Field of XPDL file upload

Record Id

Record ID of form record, if not filled, default value will be current process record ID.