Introduction

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:

1. BPMN to XPDL Conversion

This plugin bundle is compatible with Joget DX 8.

Expected Outcome

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)

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

Get Started

Current Supported Notations

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.

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.

Figure 5: Plugin Configurations

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

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.

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.

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.

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. 

Figure 10: Successful imported XPDL to Joget Process

BPMN to XPDL Conversion Properties

Configure BPMN to XPDL Conversion

Figure 11: Plugin Configurations for tool