Customization of jBPM 6

[marccbr]

First of all I am a newbie to jBPM, I need to make some changes to the jBPM 6 console for example add a add another link to the main toolbar at the top.  Create a totally new page for that link using some of the code in "Project Management".  My main question is what zip files will I need to pull down from the GitHub repository to make the changes and rebuild the jbpm-console.war file so that I can redeploy it with the changes.

[salaboy21]

Hi Marco,

I recommend you to clne the source code from github instead of downloading the zip file.

In order to build the latest source code of the console you need to:

0) install git and maven in your local machine

1) git clone https://github.com/droolsjbpm/jbpm-console-ng.git

2) mvn clean install (inside the created jbpm-console-ng directory)

3) if you want to run it you need to cd jbpm-console-ng-showcase/

4) run mvn gwt:run -> this will start up a mode called Hosted Mode (or Development Mode) that allows you to run the app without deploying the application in a servlet container or application server (it basically start an embedded jetty server and deploys the application for you).

If you have troubles let us know, we are more than happy to help people to customise the console. If you can contribute back with some features that will be awesome.

Cheers

[marccbr]

Thanks, I very much appreciate the help.  Installing now.  I will probably need some more help when I begin modifying the code, I'll let you know.

[salaboy21]

Great! Keep us posted.. and please mark the questions as resolved

[marccbr]

I have a question that has popped up.  I have made some modifications to to the jbpm-console-ng-bpm-home-client.jar and jbpm-console-ng-buisness-domain-client.jar they have compiled but I can't find where to drop these jar files.

Also is there and documentation that describes how all these jar files work together and what parts of the GUI us what jars?

[salaboy21]

Hi Marco,

good to know that you are making modifications in the jbpm console modules. Please feel free to share your progress, so we can see if we can include those back in the community code.

In the documentation you can find some pointers about how the screens are related to code:

http://docs.jboss.org/jbpm/v6.0.1/userguide/jBPMConsole.html

http://docs.jboss.org/jbpm/v6.0.1/userguide/jBPMRuntimeManagement.html

I know that is not extremely detailed, but feel free to ask questions about it. If you analyse the modules inside the jbpm console ng project, there is a one to one relationship with the screens in each section. Then inside each -client module you will find a package per screen in most of cases. So for example you will find :

https://github.com/droolsjbpm/jbpm-console-ng/tree/master/jbpm-console-ng-human-tasks/jbpm-console-ng-human-tasks-client/src/main/java/org/jbpm/console/ng/ht/client/editors/taskslist

Which is the package that contains the task list implementation. In the same way you will find the task details, etc.

If you have modified one or more of the modules you will need to compile the -showcase project to pick up the changes and compile all the modules together (this is because of GWT). So just build your modules with maven and then do an mvn clean install inside the jbpm-consolen-ng-showcase and you are ready to go.

I don't know if you are aware of the GWT Development Mode that will help you to test the project without the need to deploy the war inside an application server. You can run this mode after compiling the project with mvn gwt:run

HTH

[melissapalmer]

Hi, I am trying to customize in a simlar way to yourself and have followed the above steps on Windows however. When running "mvn clean install -DskipTests -e"  I always get the following Error : "CreateProcess error=206, The filename or extension is too long"

I do realize this is a Maven issue and have followed a number of steps out there without any luck at all.

eg: http://blog.athico.com/2014/06/compiling-gwt-applications-on-windows.html?showComment=1408085386704#c3443041006970895787

or http://stackoverflow.com/questions/8181098/the-command-line-is-too-long-in-java-project-with-maven

Is there any chance some knows how to get around this?

Thanks in advance.

[salaboy21]

Melissa, did you tried the one described in blog athico?

That should be the solution, what problem did you find with that approach?

Regards