jBPM User Guide
iii
......................................................................................................................................... v
1. Overview ...................................................................................................................... 1
1.1. Modeling ............................................................................................................ 1
1.1.1. Drools Flow Eclipse Plugin for creating BPMN2 processes .......................... 1
1.1.2. jBPM5 Eclipse Plugin for creating BPMN2 processes ................................. 2
1.1.3. Web-based process modeling using Oryx Designer .................................... 3
1.2. Deployment ........................................................................................................ 4
1.3. Execution ........................................................................................................... 4
1.3.1. Process engine ........................................................................................ 4
1.3.2. Human task service ................................................................................. 6
1.4. Monitoring .......................................................................................................... 7
1.4.1. Web-based management console ............................................................. 8
2. Installer ...................................................................................................................... 11
2.1. Prerequisites ..................................................................................................... 11
2.2. Download the installer ....................................................................................... 11
2.3. Demo setup ...................................................................................................... 11
2.4. Using Eclipse Tooling ........................................................................................ 12
2.5. Using web management consoles ...................................................................... 13
2.6. Using Guvnor repository .................................................................................... 14
2.7. What to do if I encounter problems or have questions? ........................................ 15
2.8. Frequently asked questions ............................................................................... 15
3. Processes .................................................................................................................. 17
3.1. Creating a process ............................................................................................ 17
3.1.1. Using the graphical BPMN2 Editor .......................................................... 17
3.1.2. Defining processes using XML ................................................................ 18
3.1.3. Defining Processes Using the Process API .............................................. 20
3.2. Using a Process in Your Application .................................................................. 20
3.3. Detailed Explanation of the Different Node Types ............................................... 21
3.4. Data ................................................................................................................. 29
3.5. Constraints ....................................................................................................... 30
3.6. Actions ............................................................................................................. 31
3.7. Events .............................................................................................................. 32
3.8. Timers .............................................................................................................. 33
3.9. Updating processes .......................................................................................... 34
3.9.1. Process instance migration ..................................................................... 34
4. BPMN 2.0 ................................................................................................................... 37
4.1. Business Process Model and Notation (BPMN) 2.0 specification .......................... 37
4.2. Examples ......................................................................................................... 41
4.3. Supported elements / attributes ......................................................................... 42
5. API ............................................................................................................................. 47
5.1. The jBPM API .................................................................................................. 48
5.1.1. Knowledge Base .................................................................................... 48
5.1.2. Session ................................................................................................. 48
5.1.3. Events ................................................................................................... 51
jBPM User Guide
iv
5.2. Knowledge-based API ....................................................................................... 52
6. Human Tasks ............................................................................................................. 55
6.1. Human tasks inside processes .......................................................................... 55
6.1.1. Swimlanes ............................................................................................. 58
6.2. Human task management component ................................................................ 59
6.2.1. Task life cycle ........................................................................................ 59
6.2.2. Linking the task component to the jBPM engine ....................................... 61
6.2.3. Starting the Task Management Component ............................................. 62
6.2.4. Interacting With the Task Management Component .................................. 64
6.3. Human Task Management Interface ................................................................... 65
6.3.1. Eclipse integration .................................................................................. 65
6.3.2. Web-based Task View ............................................................................ 65
7. Domain-specific processes ........................................................................................ 67
7.1. Introduction ....................................................................................................... 67
7.2. Example: Notifications ....................................................................................... 68
7.2.1. Creating the work definition .................................................................... 68
7.2.2. Registering the work definition ................................................................ 69
7.2.3. Using your new work item in your processes ............................................ 69
7.2.4. Executing service nodes ......................................................................... 71
8. Persistence ................................................................................................................ 73
8.1. Runtime State ................................................................................................... 73
8.1.1. Binary Persistence ................................................................................. 73
8.1.2. Safe Points ............................................................................................ 73
8.1.3. Configuring Persistence .......................................................................... 73
8.1.4. Transactions .......................................................................................... 77
8.2. Process Definitions ........................................................................................... 78
8.3. History Log ....................................................................................................... 78
8.3.1. Storing Process Events in a Database ..................................................... 78
9. Console ...................................................................................................................... 81
9.1. Installation ........................................................................................................ 81
9.2. Running the process management console ........................................................ 81
9.2.1. Managing process instances ................................................................... 83
9.2.2. Human task lists .................................................................................... 93
9.2.3. Reporting ............................................................................................... 95
9.3. Adding new process / task forms ....................................................................... 99
9.4. REST interface ............................................................................................... 100
10. Business Activity Monitoring ................................................................................. 101
10.1. Reporting ...................................................................................................... 101
10.2. Direct Intervention ......................................................................................... 103
Index ............................................................................................................................. 105
v
