Custom Input Editors in jBPM Designer

jBPM Designer already includes a number of useful input editors for things like Process Variables, Task Data Inputs/Outputs, Task Assignments, Imports, Called Elements, etc but often the out-of-the-box ones are not enough and users find themselves wanting to be able to create and use their custom Input Editors for certain BPMN2.0 node properties. I’m happy to say that this is now supported!

Below is a step-by-step example on how to create a custom input editor for the Actors property of user tasks. Click on the images to enlarge.

Step 1: Choosing which property to use a Custom Editor for

Step 2: Set the property type to “Custom”

Step 3: Find the property-to-editor widget mapping file in Guvnor Global Area

Step 4: Edit the mapping file to define your own mapping

Step 5: Sample implementation of a custom editor for Actors property

Step 6: Start using your custom editor

Selected value of custom editor is saved

Custom Editors provide a very powerful and useful way to add domain-specific ways of handling data inputs. Your custom editor could for example contact your existing web services or do pretty much whatever you want which is a great way to further enhance the usability of jBPM Designer.

Custom Editor support is currently available in jBPM Designer master branch and will be part of the next release scheduled in the next weeks.

10 Responses to Custom Input Editors in jBPM Designer

  1. mohamed says:

    plz i need to try this method so

    i follow your steps until step 2 but i can’t found customeditors in global area

    how i can add customeditor to global area

    • tsurdilovic says:

      Not sure I understand your question – custom editors are part of the Designer UI, and not Drools Guvnor.

      • mohamed says:

        thank you for your reply
        but how i can use custom editor in Drools Guvnor?

      • tsurdilovic says:

        I don’t think that Guvnor currently has the ability for users to define new / change existing editors. You might want to ask that on the Drools users mailing list.

  2. razvan says:

    This feature is great.
    But users can still enter free text in editor. How can I make this editor to have the behavior of Choice editor but with custom items(selectable from that graph for example)?.
    Thank you!

    • tsurdilovic says:

      You can define a static set of options in Designer which will be displayed as a drop-down list. These elements are not dynamic. Raise a jBPM Jira for this and we will figure something out.

  3. Can I add a risk management feature button on the editor? So when I run the simulations, it will show me risk details as well?

  4. Found it… plugins_jbpms.js

    • tsurdilovic says:

      You can extend the jBPM Designer to add your own plugins. Yes you can define them in plugins.xml and also place them as include in inlineeditor.jsp. Let me know what you are working on and if you’d like to make your work a community contribution at some point. I’ll be happy to help with integration as well.

  5. Vladimir Mezera says:

    Hi, can I set parameter value to editor? I want setup value from parameter to editor. In example there is only default editor (customactorsvalue).



Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: