JBoss jBPM Concepts and jBPM Process Definition Language (jPDL)

5 min read

JBoss jBPM Concepts

JBoss jBPM is built around the concept of waiting. That may sound strange given that software is usually about getting things done, but in this case there is a very good reason for waiting. Real-life business processes cut across an organization, involve numerous humans and multiple systems, and happen over a period of time. In regular software, the code that makes up the system is normally built to “do all these tasks as soon as possible”. This wouldn’t work for a business process, as the people who need to take part in the process won’t always want or be able to “do their task now”.

The software needs some way of waiting, until the process actor is ready to do their activity. Then once they have done their activity, the software needs to know what is the next activity in the chain and then wait for the next process actor to get round to doing their bit.

The orchestration of this sequence of “wait, work, wait, work” is handled by the JBoss jBPM engine. The jBPM engine looks up our process definition and works out which way it should direct us through the process. We know the “process definition” better as our graphical process map.

jBPM Process Definition Language—jPDL

We will introduce the key terms and concepts here to get the ball rolling. We won’t linger too long over the definitions, as the best way to fix the terminology in the brain is to see it used in context. At this point, we will introduce some core terminologies for a better understanding.

The visual process map in the Designer is an example of what the JBoss jBPM project calls “Graph Oriented Programming”. Instead of programming our software in code, we are programming our software using a visual process map: referred to as a “directed graph”. This directed graph is also defined in the XML representation of the process we saw in the Source view. The graph plus the XML is a notation set, which is properly called jPDL, the “jBPM Process Definition Language”.

A process definition specified in jPDL is composed of “nodes”, “transitions”, and “actions”, which together describe how an “instance” of the process should traverse the directed graph. During execution of the process, as the instance moves through the directed graph, it carries through a “token”, which is a pointer to the node of the graph at which the instance is currently waiting. A “signal” tells the token which “transition” it should take from the node: signals specify which path to take through the process.

Let’s break this down a little bit with some more detail.


A node in jPDL is modeled visually as a box, and hence looks very similar to the activity box we are used to from our workflow and activity flow diagrams. The concept of “nodes” does subtly differ from that of activities, however.

In designing jPDL, the jBPM team have logically separated the idea of waiting for the result of an action from that of doing an action. They believe that the term “activity” blurs the line between these two ideas, which causes problems when trying to implement the logic behind a business process management system. For example, both “Seek approval” and “Record approval” would be modeled as activities on an activity flow diagram, but the former would be described as a “state” and the latter as an “action” in jPDL: the state element represents the concept of waiting for the action to happen, moving the graph to the next state.

“Node” is therefore synonymous with “state” in jPDL. “Actions” are bits of code that can be added by a developer to tell the business process management system to perform an action that needs to be done by the system: for example, recording the approval of a holiday request in a database. Actions aren’t mapped visually, but are recorded in the XML view of the process definition. We’ll cover actions a bit later.

There are different types of node, and they are used to accomplish different things. Let’s quickly go through them so we know how they are used.


A task node represents a task that is to be performed by humans. If we model a task node on our graph, it will result in a task being added to the task list of the person assigned to that task, when the process is executed. The process instance will wait for the person to complete that task and hand back the outcome of the task to the node.

JBoss jBPM Concepts and jBPM Process Definition Language (jPDL)


A state node simply tells the process instance to wait, and in contrast to a task node, it doesn’t create a task in anybody’s task list. A state node would normally be used to model the behavior of waiting for an external system to provide a response. This would typically be done in combination with an Action, which we’ll talk about soon. The process instance will resume execution when a signal comes back from the external system.

JBoss jBPM Concepts and jBPM Process Definition Language (jPDL)

Forks and Joins

We can model concurrent paths of execution in jPDL using forks and joins. For example, the changes we made to our model to design our To Be process can be modeled using forks and joins to represent the parallel running of activities. We use a Fork to split the path of execution up, and then join it back together using a Join: the process instance will wait at the Join until the parallel tasks on both sides are completed. The instance can’t move on until both chains of activities are finished. jBPM creates multiple child tokens related to the parent token for each path of execution.

JBoss jBPM Concepts and jBPM Process Definition Language (jPDL)


In modeling our process in jBPM, there are two distinct types of decision with which we need to concern ourselves. Firstly, there is the case where the process definition itself needs to make a decision, based on data at its disposal, and secondly, where a decision made by a human or an external system is an input to the process definition. Where the process definition itself will make the decision, we can use a decision node in the model.

JBoss jBPM Concepts and jBPM Process Definition Language (jPDL)

Where the outcome of the decision is simply input into the process definition at run time, we should use a state node with multiple exiting transitions representing the possible outcomes of the decision.


Please enter your comment!
Please enter your name here