Readme

Currently the userguide and devguide only show well in firefox. We'll fix this in one of the next versions. See JBPM-1895.

Link	Description
User guide	Userguide docs describing the stable and supported ways of how to work with jBPM.
Javadocs	Javadocs describing the stable and supported API
Schemadocs	Javadoc-like documentation of the jPDL XML schema and the jBPM configuration file XML schema
Developers guide	Describes more configuration, usage and tweaking options. Unleash all the flexibility in jBPM. But beware, the parts documented in this dev guide are not guaranteed to be forward compatible.

Release Notes for jBPM 4.3

Main improvements

Added BPMN 2.0 runtime engine!
Extended java activity with ejb method invocation. JBPM-2412
Added jms activity (including test facilities) JBPM-2300
Added integrated rules deployment and activities rules and rules-decision JBPM-2006
Added enhanced spring integration and created continuous integration for it JBPM-2529 & JBPM-2631
Automatic saving of updated deserialized variables JBPM-2684
Added count() capabilities to all queries in the api JBPM-2567
Fixes various bugs

DB changes

No DB upgrade necessary for upgrading from 4.2 to 4.3

API changes

DeploymentQuery.PROPERTY_NAME has been removed due to errors when sorting on name on Oracle (was already deprecated in a previous release).
DeploymentQuery.deploymentDbId(long dbid) has been changed to DeploymentQuery.deploymentId(String id) to be conistent with the query API.
The behaviour of taskService.getOutcomes(taskId) have been changed. See issue [JBPM-2492].

jPDL changes

No backward incompatible changes
Added jms, rules and rules-decision activities
Added attribute ejb-jndi-name to java activity
Added attribute propagation to all event-listeners

Configuration changes

Spring integration: Creating a processEngine bean is now done through the org.jbpm.pvm.internal.processengine.SpringHelper class (instead of the SpringConfiguration class). See the Spring chapter in the developers guide for more information.

Known Limitation

Reporting in the jBPM console does not work on Tomcat. See [JBPM-2627]

Bug

[JBPM-2491] - Deleting a ProcessInstance having a running Sub-ProcessInstance fails
[JBPM-2492] - improve task outcomes
[JBPM-2529] - jBPM-Spring Integration doesn't work for EvenListener-s
[JBPM-2575] - event-listener propagation attribute not in jpdl-4.0.xsd
[JBPM-2577] - QuerySyntaxException in HistoryService
[JBPM-2618] - Source level problem running Ant script: /examples/build.xml
[JBPM-2628] - Calling executionService.startProcessInstanceByKey with a non-existent key throws an unhelful exception
[JBPM-2639] - Task with taskform and timer leads to NPE
[JBPM-2643] - adding tasks not belonging to an execution breaks the console
[JBPM-2649] - HistoryActivityInstanceQueryImpl references wrong property for processDefinitionId
[JBPM-2651] - Error on executing a process with sub processes
[JBPM-2654] - instal.jbpm.into.jboss does not copy the MySQL driver
[JBPM-2657] - No override of convenience methods in SpringConfiguration
[JBPM-2683] - Upgrade 4.1 to 4.2 Breaks subprocess - integrity constraint (JBPM_DEV.FK_EXEC_SUBPI) violated - child record found

Feature Request

[JBPM-2412] - extend java activity targets with ejb
[JBPM-2538] - Make a TaskQuery resuable
[JBPM-2558] - SpringTransactionInterceptor: Resolve transactionManager by name
[JBPM-2567] - TaskQuery Should allow to .count() Tasks in addition of .list() them
[JBPM-2576] - Extending HistorySession - add public getters in HistoryEvents
[JBPM-2661] - BPMN2: Exclusive gateway
[JBPM-2662] - BPMN2: parallel gateway
[JBPM-2663] - BPMN2: service task (Java based)
[JBPM-2664] - BPMN2: Manual task
[JBPM-2665] - BPMN2: receive task (java message only)
[JBPM-2666] - BPMN2: script task
[JBPM-2667] - BPMN2: User task
[JBPM-2668] - BPMN2: none start/end event
[JBPM-2669] - BPMN2: terminate end event
[JBPM-2670] - BPMN2: sequence flow
[JBPM-2671] - BPMN2: conditional sequence flow
[JBPM-2673] - BPMN2: Interface (basic: Java only)
[JBPM-2674] - BPMN2: resource
[JBPM-2675] - BPMN2: document 'getting started'
[JBPM-2676] - BPMN: default sequence flow

Task

[JBPM-2006] - drools integration
[JBPM-2300] - jms activity
[JBPM-2616] - clean up JpdlDeployer
[JBPM-2623] - remove duplicate inclusion of xsd docs in the distro
[JBPM-2631] - set up spring hudson job
[JBPM-2632] - move XPathScriptEngine classes from bpmn to pvm
[JBPM-2660] - BPMN2: create basic example and document it
[JBPM-2680] - core.jar creates exception in some nested deployment on jboss
[JBPM-2684] - automatic saving of updates to serializable variables
[JBPM-2695] - investigate user testibility of java ejb invoke activity and jms

Release Notes for jBPM 4.2

Known limitations

On oracle, using DeploymentQuery.PROPERTY_NAME is causing a problem. We've deprecated the property because of that reason and in one of the next releases, the DeploymentQuery.PROPERTY_NAME will be removed.

API changes

Execution.isProcessInstance() is renamed to Execution.getIsProcessInstance due to [ JBPM-2494].

Bug

[JBPM-2467] - ForkActivity setActivity(null) breaks console integration (process state diagram and others)
[JBPM-2487] - Bug in GroupActivity.execute(ExecutionImpl execution)
[JBPM-2494] - Cannot resolve processInstance through expression
[JBPM-2502] - Queries ignore order by
[JBPM-2504] - TaskQuery has wrong / missing property constants
[JBPM-2507] - org.jbpm.integration.console.ModelAdaptor adoptTask does not copy over the task description
[JBPM-2513] - Variable value is set after history event
[JBPM-2519] - jbpm4 user guide : wrong location for the GPD plugin
[JBPM-2540] - Fix replacement of Signavio repository path on Windows
[JBPM-2544] - Console shows "HTTP Status 500" error message when process definition contains fork
[JBPM-2554] - jPDL schema does not contain an attribute "description" for the element task
[JBPM-2593] - processDefinition.getDescription() does not return the process definition description as defined in the process definition XML file
[JBPM-2599] - Unable to start new process

Feature Request

[JBPM-165] - process instance versioning
[JBPM-2521] - User docs are showing many v4.0 entries instead of current version (4.1)

Patch

[JBPM-2520] - The install build.xml is not reporting the new Signavio installtion target (patch attached)

Task

[JBPM-1460] - remove ObjectReference
[JBPM-2200] - add process classloading
[JBPM-2388] - extend coverage of jpdl process conversion tool
[JBPM-2430] - review classloading when deploying process
[JBPM-2501] - revisit jboss jbpm service archive architecture
[JBPM-2509] - database migration installation script
[JBPM-2511] - move tmp directory of signavio installation to install/generated
[JBPM-2516] - Investigate console behaviour with 2 taskforms after a fork
[JBPM-2524] - enable user domain model integration
[JBPM-2526] - implement jbpm key generation
[JBPM-2547] - Verify JDK5 compatibility of Signavio
[JBPM-2548] - deprecate deployment query name property to fix oracle name clob orderBy problem
[JBPM-2557] - remove install\src\org\jbpm\db\DbUpgrade.class from distro
[JBPM-2565] - ensure backwards compatibility for previous jpdl versions
[JBPM-2569] - update jpdl namespace
[JBPM-2578] - add process customization to developer api for debugging and simulation
[JBPM-2586] - add support for sunos in installation scripts
[JBPM-2597] - fix oracle schema creation errors
[JBPM-2598] - remove schema generation from distro build
[JBPM-2600] - Update to console 1.2.0
[JBPM-2601] - make sure upgrade on postgresql deletes the hibernate_sequence table

Feature Request

[JBIDE-4069] - When we create a transition to a node (GPD), JBDS/Tools could create the transition name automatically.
[JBIDE-4066] - Trim transition name in the 'Transition Properties Editor' of the GPD (jBPM Editor).

Task

[JBIDE-4197] - JBDS 2.0.0 GA will not deploy JBPM archive
[JBIDE-3119] - Exception logged on connection test in jBPM editor
[JBIDE-3915] - jBPM Eclipse plugin can't save graphical view if gpd.xml is marked as read only
[JBIDE-3618] - jPDL designer loses changes and cannot edit file anymore
[JBIDE-4571] - Some JBoss plugins have no Provider Name in Installation Details.

Release Notes for jBPM 4.1

DB Migration

Add column CLASSNAME_ to the JBPM4_VARIABLE table. The type of the column is dependent on the database and can be found in this table:

Hsqldb	varchar(255)
MySQL	varchar(255)
Oracle	varchar2(255 char)
PostgreSQL	varchar(255)

Tech details of the update in the jira issue: JBPM-2474

Changed functionality

Calling taskService.completeTask(String taskId, String outcome) with an unexisting outcome will throw an exception instead of suspending the process instance. (see [JBPM-2425])

Bug

[JBPM-2040] - Inconsistent behaviour depending on the ordering of events (fork+end state+join)
[JBPM-2418] - fix dueDate property in TaskQuery
[JBPM-2425] - Completing task with nonexistent outcome silently does nothing
[JBPM-2436] - Mail activity details lost when switching between source and diagram
[JBPM-2452] - freemarker templating for task forms: outcome (transitions) vs. outcome (result) clash
[JBPM-2455] - add template attribute to notification and reminder in xsd
[JBPM-2466] - task-reminder should not use task-notification template when sending mail
[JBPM-2474] - Process variables of type hibernate-long-id/hibernate-string-id don't work
[JBPM-2476] - creating new process instance from console fails to set process variables properly
[JBPM-2486] - jbpm4 user guide : small errors in doc
[JBPM-2490] - Inconsistency in user's guide: decide or select in DecisionHandler

Feature Request

[JBPM-1995] - build script to calculate jBPM DB differences
[JBPM-2210] - Add support for AS 5.1.x
[JBPM-2334] - make business calendar customizable and pluggable
[JBPM-2343] - completeTask with submitting variables
[JBPM-2479] - Integrate Signavio in distro build

Patch

[JBPM-2407] - Join multiplicity FIX
[JBPM-2445] - JBPM4-Spring 1.2 integration problems

Quality Risk

[JBPM-2446] - Jira freeze

Task

[JBPM-2301] - add start forms to jpdl and the api
[JBPM-2316] - review executability of examples in console
[JBPM-2317] - task forms examples refinement
[JBPM-2351] - review task forms
[JBPM-2353] - remove explicit jta transaction demarcation in console and deployer
[JBPM-2360] - fix deletion of deployments in cluster
[JBPM-2392] - review duedate in jpdl3 converter
[JBPM-2402] - verify job executor threads in case of errors
[JBPM-2408] - fix duplicate schemdoc entries in the distro zip file
[JBPM-2409] - expand qa capabilities and ci
[JBPM-2410] - clean up obsolete qa dbs
[JBPM-2411] - configuration tool
[JBPM-2419] - change Job.dueDate in Job.duedate
[JBPM-2432] - problem displaying process image in console
[JBPM-2433] - Review existing BI reports and enhance/add existing/new reports
[JBPM-2435] - verify online presence of xsd's
[JBPM-2437] - add start task form capability to console
[JBPM-2438] - move settings to the bottom
[JBPM-2439] - make task lists the home page
[JBPM-2440] - define subset of jpdl schema for tooling
[JBPM-2480] - Create demo for JBW
[JBPM-2498] - improve exception message when execution not found

Release Notes for jBPM 4.0 (GA)

Known Issues

There are still 2 known minor inconveniences in the Graphical Process Designer (GPD). For workarounds, see the jira issues:

[GPD-306] - Self Referencing Connections
[GPD-336] - image generation fails

Bug

[JBPM-2022] - EnvironmentFactory cannot be bound to JNDI
[JBPM-2055] - Executions that are ended show up in query
[JBPM-2303] - Exception with a process containing a fork/join
[JBPM-2313] - Unabled to enlist resource exception
[JBPM-2319] - Finished executions are not changed to "ended" (they stay in the "active" state)
[JBPM-2331] - StaleObjectException on Timer execution.
[JBPM-2332] - task query candidate problem
[JBPM-2335] - Subprocess Element causes Exception if followed by an <end> Element
[JBPM-2340] - TaskService getTaskComments throws NullPointerException if the task is not found
[JBPM-2344] - JTA interceptor breaks console and deployer
[JBPM-2355] - Unable to retrieve suspended process defintions
[JBPM-2387] - integrity constraint violation in process that runs end to end with no wait
[JBPM-2389] - Reassignment is not reflected in task history
[JBPM-2390] - add tasks and task comments the history

Feature Request

[JBPM-2052] - Suspend / Resume executions
[JBPM-2102] - Provide process definition lifecycle
[JBPM-2305] - Implement a method in TaskService to return all active tasks of a process instance
[JBPM-2309] - Add method to support getTaskDefinition and getProcessInstance from interface Task
[JBPM-2342] - extend repo service to get a list of deployments
[JBPM-2352] - jPDL Schema definition needs some tweaks

Task

[JBPM-1214] - check optimistic locking in case of loops
[JBPM-1895] - verify html documentation style sheets for internet explorer
[JBPM-2004] - finish database cleanup of all the tests
[JBPM-2016] - finalize test support
[JBPM-2110] - Delegate deployment-service dependency resolution to the dependecy deployer in AS 5
[JBPM-2183] - process conversion tool
[JBPM-2212] - review string == comparisons for execution.state
[JBPM-2223] - event propagate property
[JBPM-2275] - handle async message jobs after process instance deletion
[JBPM-2286] - create test case with fork and join in one transaction
[JBPM-2304] - investigate non-null return values for collections in the api
[JBPM-2306] - fix developers guide
[JBPM-2307] - prune api where possible
[JBPM-2314] - Clean up validate(Timer)
[JBPM-2322] - enable module test-db in integration test suite
[JBPM-2323] - instantiate user defined classes at parsing time
[JBPM-2328] - move timers to devguide
[JBPM-2330] - fine tuning of the execution id generator
[JBPM-2336] - fix delete task mismatch
[JBPM-2339] - Complete JTA transaction refactoring
[JBPM-2348] - make ids consistent
[JBPM-2350] - move jboss process deployment to incubation
[JBPM-2354] - fix excluded integration tests for test-db
[JBPM-2356] - fine tuning of execution persistence hierarchy
[JBPM-2357] - Change findExecutionById to show suspended executions
[JBPM-2359] - reporting test fails on oracle
[JBPM-2362] - integrate andries' spring integration
[JBPM-2363] - document purpose of ant script installations
[JBPM-2364] - split mail documentation in userguide and devguide part
[JBPM-2365] - Clarification (and API) how "Start process with task form" should work
[JBPM-2367] - verify examples classes deployment in demo.setup script
[JBPM-2370] - Incorporate Migration tool in distribution
[JBPM-2371] - add mysql schema diagram to db docs
[JBPM-2372] - complete javadocs
[JBPM-2374] - image problem
[JBPM-2376] - putting a task back in the group
[JBPM-2378] - add continue attribute to xsd
[JBPM-2379] - regression on oracle related to clobs
[JBPM-2393] - expand task history to full audit logs
[JBPM-2395] - fix mail listener: change task variable to task scope
[JBPM-2396] - remove TaskServive.getVariable method

Task

[GPD-226] - Define a repeatable build for these plugins to be exported as a feature
[GPD-229] - Write up the initial test scenario's to test the GPD (automated or manual)
[GPD-288] - Errors show up in problems view
[GPD-301] - migration support
[GPD-331] - Support HQL attributes and elements
[GPD-333] - Ensure backwards compatibility between GPD 3.1.x and GPD 4.x
[GPD-334] - update jbpm roadmap with gpd features
[GPD-341] - renaming swimlane should make editor dirty
[GPD-351] - Modify project and jpdl creation wizards to allow for jBPM 3 and jBPM 4 to coexist

Release notes for jBPM 4.0.0.CR1

Known Limitations

In the Graphical Process Designer, the hql and sql nodes are not yet configurable
In the Graphical Process Designer, the custom node is supported but not completely configurable
In the Graphical Process Designer, the wire object type configurations are limited to strings

Bug

[JBPM-2284] - Process definition search by name does not work
[JBPM-2296] - Fork activities create the wrong type of child executions

Feature Request

[JBPM-2266] - Task history on canceled instances/tasks
[JBPM-2279] - The java,hql,sql activities should be able to receive execution context variables
[JBPM-2294] - examples fail against postgresql

Task

[JBPM-2048] - simplify sessions
[JBPM-2124] - remove task id property
[JBPM-2147] - Fix integration test suite
[JBPM-2148] - StringBuffer Use in jBPM 4
[JBPM-2150] - Update hibernate oracle dialect
[JBPM-2174] - verify different table names for jbpm 4
[JBPM-2184] - View Process Image
[JBPM-2214] - consider sub process parameters
[JBPM-2215] - make the set of value types concrete
[JBPM-2216] - add custom activity
[JBPM-2220] - add method TaskService.getOutcomes()
[JBPM-2221] - null outcome for a task must bind to the single transition
[JBPM-2228] - remove esb activity
[JBPM-2231] - introduce system variables
[JBPM-2242] - add deployment state
[JBPM-2250] - decide on task list names
[JBPM-2251] - separate specific integration test suite deployments
[JBPM-2252] - update api usage of the state activity docs
[JBPM-2256] - add async continuations
[JBPM-2257] - verify persistence of task variables
[JBPM-2261] - check history information
[JBPM-2264] - removed previous methods
[JBPM-2265] - refactor 4.0.0 to 4.0
[JBPM-2269] - add resource lookup by process definition id
[JBPM-2277] - refactor job configuration
[JBPM-2278] - verify publication of enterprise module jar
[JBPM-2281] - figure out dependecies for Element.setUserData
[JBPM-2282] - document how to deploy a process
[JBPM-2283] - document migration strategy and limitations

Sub-task

[JBPM-2026] - add group activity

Bug

[GPD-338] - saving a process changes the namespace
[GPD-340] - on elements are removed from activities
[GPD-345] - XML namespaces are not consistent between GPD and the engine
[GPD-348] - jdpl.xml xmlns altered wrong

Task

[GPD-304] - Analyze backwards compatibility between GPD 3.1.x and GPD 4.x
[GPD-316] - show problems in problems view
[GPD-320] - save process image
[GPD-322] - create sub-process image in userguide
[GPD-323] - timer on events and on transitions
[GPD-324] - support process attributes and elements
[GPD-325] - Support decision attributes
[GPD-326] - support end event attributes
[GPD-327] - support sub-process elements
[GPD-328] - support Java attributes and elements
[GPD-329] - support Script attributes and elements
[GPD-332] - Event Listeners on activities and transitions
[GPD-335] - add proper licence text
[GPD-342] - decision handler element should be deserialized properly
[GPD-343] - Adding second swimlane should be reflected in details view
[GPD-346] - Allow for configuration of jBPM 4 runtime locations
[GPD-349] - support the custom node
[GPD-350] - Remove ESB node temporarily

Release Notes - JBoss jBPM - Version jBPM 4.0.0.Beta2

Bug

[JBPM-2158] - ClassCastException when start a processDeifinition which is not in the RepositoryCache.
[JBPM-2222] - StackOverflowError in HistoryActivityInstanceQueryImpl

Feature Request

[JBPM-1926] - Remove dependency on jBPM3
[JBPM-2101] - TX interceptor with 'required' semantics

Task

[JBPM-1459] - getDefaultTransition
[JBPM-2015] - Update to hibernate 3.3.1.GA
[JBPM-2058] - email templates
[JBPM-2123] - rename exclusive to decision
[JBPM-2134] - remove execution mgmt methods from ActivityExecution
[JBPM-2150] - Update hibernate oracle dialect
[JBPM-2159] - recreate jbpm.jar file
[JBPM-2162] - revert process archive deployment in examples
[JBPM-2163] - configuration phase 2
[JBPM-2165] - rename xsd
[JBPM-2168] - align query methods with hibernate
[JBPM-2170] - ant task for deployment
[JBPM-2171] - clarifying api by introducing ProcessInstance interface
[JBPM-2173] - rename api packages to org.jbpm.api
[JBPM-2175] - add xsd back to distribution
[JBPM-2176] - allow for easy creation of demo data
[JBPM-2177] - expose activity coordinates programmatically
[JBPM-2179] - Include GWT console Beta3
[JBPM-2180] - add attribute form to task
[JBPM-2181] - remove cfg.xsd
[JBPM-2182] - change jpdl namespace
[JBPM-2204] - sub-process images in the userguide

Sub-task

[JBPM-2025] - add sub-process
[JBPM-2027] - add event listeners
[JBPM-2029] - add timers

Bug

[GPD-311] - subelements of transition are removed when saving

Task

[GPD-282] - Implement jPDL properties mechanism for jBPM 4
[GPD-310] - remove empty transition names
[GPD-314] - activity renamings
[GPD-315] - make pallete consistent
[GPD-320] - save process image
[GPD-322] - create sub-process image in userguide

Sub-task

[GPD-317] - swimlane configuration
[GPD-318] - event listener configuration
[GPD-319] - timer configuration

Release notes for jBPM 4.0.0.Beta1

Bug

[JBPM-2109] - Server shutdown undeployment calls have unmet dependency
[JBPM-2120] - javax.el.* API conflict in AS 5
[JBPM-2144] - Oracle JDBC properties are not replaced in distro
[JBPM-2145] - oracle-ds doesn't work on JDK 6
[JBPM-2149] - Storing the archive location exceeds max character limitation
[JBPM-2151] - no environment to get org.jbpm.session.RepositorySession

Feature Request

[JBPM-1999] - Add the notion of "outcome" to the base task model
[JBPM-2054] - Introduce REST friendly ID's

Task

[JBPM-2030] - Leverage examples as integration test suite
[JBPM-2073] - Update the screenshots of the examples
[JBPM-2075] - revisit deployment
[JBPM-2077] - config tool
[JBPM-2080] - finish task activity
[JBPM-2104] - task example scenarios
[JBPM-2108] - Provide deployers for jboss 4 & 5
[JBPM-2113] - Re-introduce database config and DDL scripts in distro
[JBPM-2118] - add task variable methods
[JBPM-2152] - Document the jboss integration

Sub-task

[JBPM-2024] - add swimlanes

Release notes for jBPM 4.0.0.Alpha2

Bug

[JBPM-1980] - Failed to initialze ScriptEngineManager on JDK 1.5
[JBPM-1981] - Example tests fail
[JBPM-2049] - hbm2ddl.auto doesn't work within AS
[JBPM-2072] - ConnectionManager deadlock running XA transaction on AS 4

Feature Request

[JBPM-1946] - IzPack installer for jBPM4 that supports JBoss
[JBPM-1993] - Interface with the JBoss identity component
[JBPM-1998] - Dinstinction between candiadate-groups and candidate-users in Task API and model

Task

[JBPM-1246] - document build
[JBPM-1280] - build out job executor basic test coverage
[JBPM-1411] - migrate enterprise into separate module
[JBPM-1753] - review event names
[JBPM-1759] - cleanup excluded tests
[JBPM-1861] - complete taskservice api
[JBPM-1967] - rename flow to transition
[JBPM-1971] - fix test-load hudson job in qa lab
[JBPM-1972] - introduce process definition attachments
[JBPM-1973] - finish programmatic process definition creation
[JBPM-1974] - rename node to activity
[JBPM-1977] - Provide process management through the GWT console on jbpm4
[JBPM-1978] - configure pvm2 user for hudson job jbpm4-load
[JBPM-1983] - rename context environment to transaction
[JBPM-1986] - rename ExecutionService.startExecutionXxx methods to startProcessInstanceXxx
[JBPM-1997] - API package refactoring
[JBPM-2003] - document release procedure in a wiki page
[JBPM-2020] - fix timer mapping
[JBPM-2032] - verify blob caching
[JBPM-2039] - initial history infrastructure
[JBPM-2041] - move task mgmt into pvm module
[JBPM-2044] - Distribute GPD through the installer
[JBPM-2063] - examples hibernate configuration file
[JBPM-2064] - re-introduce schema sql scripts in distro

Sub-task

[JBPM-2011] - Move non public classes to **/internal
[JBPM-2012] - Split jars into *-api.jar and *-impl.jar

Task

[GPD-281] - Release jBPM Designer 4.0.0 Alpha2
[GPD-283] - Implement a tree structured details view for graphical entities
[GPD-287] - XML preservation
[GPD-294] - Update to new icons

Release notes for jBPM 4.0.0.Alpha1

Finally.. phew !