Pular para o conteúdo principal

Hacking BPM Suite/jBPM 6.0.x to make REST endpoints available as a Javascript API

You might know that BPM Suite/jbpm 6.0.x(which difference I explained in this post, from now I will only mention BPM Suite) has a great REST API to interact with processes and tasks. If you want to explore the API endpoints, there's a "hidden" page with a summary of all endpoints at http://localhost:8080/business-central/rest-api.jsp:



If you want to consume this API you must either create a client and/or use the remote Java API. If you want to consume it from javascript, you need to do some coding in order to get the data from the API. But there's a short way using the RESTEasy Javascript servlet.

In my example I am using JBoss EAP 6.1, although this should be possible with other application servers, I will focus only in BPM Suite 6.0.3 installed in JBoss EAP.

To enable the servlet, first edit the file  standalone/deployments/business-central.war/WEB-INF/web.xml and add the RESTEasy javascript servlet declaration:

Now after you start BPM Suite the API should be available already and you should be able to call the REST API directly in your code with two warnings:

  • As the information is retrieved from JAX-RS resources, you must eager start resteasy or reach the REST API endpoint at least one time in order to start resteasy, otherwise you will face errors when accessing the javascript for the first time;
  • The API calls requires credentials. You can decided to either ask for them in your app that uses the javascript API or be logged in the business central before.
In my installation, here is the generated Javascript API. Having this in mind, you are free to use the javascript API! Here is a very simple page that lists all the tasks for the user "jesuino":



Conclusion

Notice that this is just the start to explore this generated API. Also, please notice this might expose your BPM Suite installation, so be careful with this feature
Keep in mind that BPM Suite is a product supported by Red Hat and this is not a feature supported by Red Hat, it is my personal experience with the API.


Comentários

Postagens mais visitadas deste blog

Genetic algorithms with Java

One of the most fascinating topics in computer science world is Artificial Intelligence . A subset of Artificial intelligence are the algorithms that were created inspired in the nature. In this group, we have Genetic Algorithms  (GA). Genetic Algorithms  To find out more about this topic I recommend the following MIT lecture and the Nature of Code book and videos created by Daniel Shiffman. Genetic Algorithms using Java After I remembered the basics about it, I wanted to practice, so I tried my own implementation, but I would have to write a lot of code to do what certainly others already did. So I started looking for Genetic Algorithm libraries and found Jenetics , which is a modern library that uses Java 8 concepts and APIs, and there's also JGAP . I decided to use Jenetics because the User Guide was so clear and it has no other dependency, but Java 8. The only thing I missed for Jenetics are more small examples like the ones I will show i...

Simplest JavaFX ComboBox autocomplete

Based on this Brazilian community post , I've created a sample Combobox auto complete. What it basically does is: When user type with the combobox selected, it will work on a temporary string to store the typed text; Each key typed leads to the combobox to be showed and updated If backspace is type, we update the filter Each key typed shows the combo box items, when the combobox is hidden, the filter is cleaned and the tooltip is hidden:   The class code and a sample application is below. I also added the source to my personal github , sent me PR to improve it and there are a lot of things to improve, like space and accents support.

Dancing lights with Arduino - The idea

I have been having fun with Arduino these days! In this article I am going to show how did I use an electret mic with Arduino to create a Dancing Lights circuit. Dancing Lights   I used to be an eletronician before starting the IT college. I had my own electronics maintenance office to fix television, radios, etc. In my free time I used to create electronic projects to sell and I made a few "reais" selling a version of Dancing lights, but it was too limited: it simply animated lamps using a relay in the output of a 4017 CMOS IC. The circuit was a decimal counter  controlled by a 555. 4017 decimal counter. Source in the image When I met Arduino a few years ago, I was skeptical because I said: I can do this with IC, why should I use a microcontroller. I thought that Arduino was for kids. But now my pride is gone and I am having a lot of fun with Arduino :-) The implementation of Dancing Lights with Arduino uses an electret mic to capture the sound and light leds...